{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hv7kj8p3bt7d","handle":"archery-sql-mcp","url":"https://wellknown.network/agents/archery-sql-mcp","links":{"self":"https://wellknown.network/agents/archery-sql-mcp/record.json","html":"https://wellknown.network/agents/archery-sql-mcp","markdown":"https://wellknown.network/agents/archery-sql-mcp/record.md","api":"https://wellknown.network/api/v1/agents/archery-sql-mcp","status":"https://wellknown.network/api/v1/agents/archery-sql-mcp/status","claim":"https://wellknown.network/agents/archery-sql-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/archery-sql-mcp/claim.json","badge":"https://wellknown.network/agents/archery-sql-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/archery-sql-mcp/history","tools":"https://wellknown.network/api/v1/agents/archery-sql-mcp/tools"},"ard":{"identifier":"urn:air::server:archery-sql-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"archery-sql-mcp","summary":"Archery SQL 查询 MCP 工具：自动登录 + 会话自愈 + 只读查询，供任意 MCP 客户端与 CLI 使用","description":"# archery-sql-mcp\n\nArchery SQL 平台（sql.tec-develop.com）查询工具：**自动登录 + 会话自愈 + 只读查询**。\n双模式运行——无参数启动为 MCP stdio server（任何 MCP 客户端可接入），带子命令则为 CLI。\n\n## 安装\n\n发布到 PyPI 后（最短路径）：\n\n```bash\nuvx archery-sql-mcp --help          # 免安装直接跑\nuv tool install archery-sql-mcp     # 或安装为全局命令\n```\n\n从内部 Git 仓库：\n\n```bash\nuv tool install git+https://git.tec-do.cn/<group>/archery-mcp.git\n```\n\n本地开发：\n\n```bash\ngit clone <仓库地址> && cd archery-mcp\nuv run --project . archery-sql-mcp --help\n```\n\n## 初始化账号密码（一次性）\n\n```bash\narchery-sql-mcp init\n```\n\n交互式录入 Archery 地址 / 用户名 / 密码（不回显）/ 默认实例 / 默认库，\n写入 `~/.archery-mcp/config.json` 并立即登录验证。\n\n> 密码为本地明文存储（仅存于本机用户目录，不进任何 git 仓库）。\n> 不想落盘的机器可改用环境变量：`ARCHERY_USERNAME` / `ARCHERY_PASSWORD` /\n> `ARCHERY_BASE_URL` / `ARCHERY_INSTANCE` / `ARCHERY_DB`。\n\n会话缓存于 `~/.archery-mcp/session.json`，冷启动自动复用（最长约两周），\n过期自动重新登录，调用方无感。\n\n## 自检与使用\n\n```bash\narchery-sql-mcp check    # 登录 + SELECT 1 全链路验证\narchery-sql-mcp instances # 列出有读权限的数据库实例\narchery-sql-mcp query \"SELECT id, status, error_message FROM cv_video_script_audit_tasks ORDER BY created_at DESC LIMIT 10\"\narchery-sql-mcp redis \"scan 0 match creator_email:* count 100\"   # 只读查线上 Redis\n```\n\n仅允许 `SELECT` / `WITH` 开头的语句（可在配置 `allowed_prefixes` 扩展）。\n\n## 一键注册到各 agent 客户端\n\n```bash\n# 注册到全部支持的 agent 的用户级配置（zcode / claude-code / claude-desktop / codex / cursor）\nuvx archery-sql-mcp install-mcp\n\n# 仅注册指定 agent，写入当前目录的项目级配置（进 git 共享，command 自动用可移植的 uvx）\nuvx archery-sql-mcp install-mcp --agents claude-code,codex --scope project\n```\n\n写入规则：合并式更新（保留配置文件中的既有内容）、幂等（重复执行不产生重复条目）、\n用户级默认写入本机 uvx 绝对路径、项目级默认写入可移植的命令名 `uvx`（加 `--portable` 强制全局可移植）。\n各 agent 写入位置：ZCode `~/.zcode/cli/config.json`（mcp.servers）· Claude Code `~/.claude.json` / 项目 `.mcp.json` ·\nClaude Desktop `%APPDATA%\\Claude\\claude_desktop_config.json` · Codex `~/.codex/config.toml`（mcp_servers 段）·\nCursor `~/.cursor/mcp.json` / 项目 `.cursor/mcp.json`。写入后重启对应客户端会话生效。\n\n## 接入 MCP 客户端（手工方式）\n\nZCode（`~/.zcode/cli/config.json`）、Claude Desktop、Cursor（`~/.cursor/mcp.json`）同构：\n\n```jsonc\n{\n  \"mcpServers\": {\n …","publisher":null,"homepage":null,"repository":null,"version":"0.4.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:archery-sql-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"archery-sql-mcp","registry":"pypi","observedAt":"2026-11-08T23:27:29.474Z","publishedAt":"2026-08-28T06:23:19.066991Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"archery-sql-mcp","url":"https://pypi.org/project/archery-sql-mcp/","firstSeenAt":"2026-09-09T09:23:27.768Z","fetchedAt":"2026-11-08T23:26:24.021Z","normalizedAt":"2026-11-08T23:26:24.021Z"}]},"firstSeenAt":"2026-09-09T09:23:27.768Z","updatedAt":"2026-11-08T23:27:29.474Z"}