archery-mcp
— let your AI coding agent inspect production table schema and validate release SQL through your own Archery platform, with permissions, row limits and data masking still enforced by Archery itself.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
uvx archery-mcp==0.1.1Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
ARCHERY_BASE_URL=<value> ARCHERY_USERNAME=<value> ARCHERY_PASSWORD=<secret> ARCHERY_TOTP_SECRET=<secret> ARCHERY_INSTANCE_NAME=<value> ARCHERY_DB_NAME=<value> ARCHERY_SCHEMA_NAME=<value> ARCHERY_QUERY_LIMIT=<value> claude mcp add io.github.itzhouq-archery-mcp -- uvx archery-mcp==0.1.1รันในเทอร์มินัล
{ "mcpServers": { "io.github.itzhouq-archery-mcp": { "command": "uvx", "args": [ "archery-mcp==0.1.1" ], "env": { "ARCHERY_BASE_URL": "<value>", "ARCHERY_USERNAME": "<value>", "ARCHERY_PASSWORD": "<secret>", "ARCHERY_TOTP_SECRET": "<secret>", "ARCHERY_INSTANCE_NAME": "<value>", "ARCHERY_DB_NAME": "<value>", "ARCHERY_SCHEMA_NAME": "<value>", "ARCHERY_QUERY_LIMIT": "<value>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
— let your AI coding agent inspect production table schema and validate release SQL through your own Archery platform, with permissions, row limits and data masking still enforced by Archery itself.
Read-only MCP server for the Archery SQL audit platform: production schema and release SQL checks
中文:archery-mcp 是一个 MCP Server,把 Archery SQL 审核平台的在线查询与 SQL 检查能力带给 AI 编码助手(Claude Code、Cursor、Codex CLI 等)。AI 在写代码时可以直接查看线上表结构、验证数据特征、检查上线 SQL 规范,而不需要你手动比对环境差异。
[!IMPORTANT]
- 本项目与 Archery 官方无隶属关系,是独立的非官方客户端;
- 本项目按"现状"提供(MIT License)。使用者须自行取得公司授权并遵守公司数据安全规定,作者不对违规使用及其后果负责;
- 安全模型:本 MCP 不在本地过滤 SQL 或遮蔽数据,权限、行数上限、超时与脱敏完全由你自己的 Archery 平台执行——请给 MCP 配置专用的最小权限账号(见安全模型)。
日常迭代业务系统时,常见的三个痛点:
DESC 生产表、核对索引,再让 AI 照着写——重复、低效、易错;这些问题的共同解法是:让 AI 在编码工作流中随时、只读地"看见"生产库——而不是绕过审批直连数据库。如果公司已经在用 Archery 管理 SQL 查询和上线工单,权限、审计、脱敏、工单流都已经在 Archery 里,那么把 Archery 的查询能力封装成 MCP 工具,就是最稳妥的路径。这正是 archery-mcp 做的事。
flowchart LR
A["MCP 客户端<br/>Claude Code / Cursor / Codex CLI"] -->|"MCP stdio"| B["archery-mcp<br/>锁定目标 + 内置规范检查"]
B -->|"会话登录 + CSRF + TOTP"| C["Archery 平台<br/>权限 · 审计 · 脱敏 · 行数限制"]
C -->|"只读在线查询"| D[("生产数据库")]
/api/v1/workflow/sqlcheck/)合并出结论,平台不可用时优雅降级。sql_check 内置规范要点(规则实现在 src/archery_mcp/sql_rules.py,errlevel 语义与 Archery 一致:0 通过 / 1 警告 / 2 错误):
定位差异:archery-mcp 面向"嵌入日常迭代开发流"——固定目标、只读优先、上线前检查,牺牲灵活性换取更低的误操作面。
前置条件:Python 3.11+,一个能访问 Archery 的账号(建议专用最小权限账号),且账号有在线查询权限。
方式一:uvx(推荐,无需安装)
uvx archery-mcp
方式二:pip
pip install archery-mcp
方式三:源码
git clone https://github.com/itzhouq/archery-mcp
cd archery-mcp
python -m pip install -e .
以 Claude Code 为例,在项目根目录 .mcp.json(或全局配置)中加入:
{
"mcpServers": {
"archery_mcp": {
"command": "uvx",
"args": ["archery-mcp"],
"env": {
"ARCHERY_BASE_URL": "https://archery.example.com",
"ARCHERY_USERNAME": "你的 Archery 用户名",
"ARCHERY_PASSWORD": "你的 Archery 密码",
"ARCHERY_TOTP_SECRET": "",
"ARCHERY_INSTANCE_NAME": "prod-app-db",
"ARCHERY_DB_NAME": "app_db",
"ARCHERY_SCHEMA_NAME": "public",
"ARCHERY_QUERY_LIMIT": "100"
}
}
}
}
Cursor / Codex CLI 等其他客户端使用相同的 command / args / env 结构。保存后重启客户端即可。凭据只经进程环境变量传递,不要写入任何会提交的文件。
由 Archery 负责的部分(本 MCP 原样委托,不做本地重复实现):
critical_ddl_regex);is_masked 会随查询结果返回);query_history 工具可直接查看)。由 MCP 锁定的部分:
部署建议:
sql_check 需要账号在 Archery 的 API 用户白名单(api_user_whitelist)内并拥有上线权限(sql.sql_submit);不可用时本地规范结果仍会返回。免责声明:本项目按"现状"提供,不含任何担保。使用本工具访问生产数据库前,请确认你已获得公司授权、遵守公司数据安全与合规规定。因违反公司规定或平台策略使用本工具导致的任何后果由使用者自行承担。
python -m pip install -e ".[dev]"
python -m pytest -q # 46 个测试,全部 Mock,不访问真实 Archery
ruff check src tests scripts
bash scripts/check_sensitive.sh # 敏感信息扫描
对真实 Archery 的冒烟验证(会登录并执行只读查询):
ARCHERY_BASE_URL="https://archery.example.com" \
ARCHERY_USERNAME="你的用户名" \
ARCHERY_PASSWORD="你的密码" \
python scripts/smoke_readonly.py # 表清单 → 表结构 → SELECT *
python scripts/smoke_sql_check.py # 上线 SQL 检查(只检查不执行)
python scripts/smoke_mcp_stdio.py # MCP stdio 全链路
架构与设计决策的完整说明见 docs/ARCHITECTURE.md,参与开发见 CONTRIBUTING.md。
登录报"用户名或密码错误",但网页能正常登录?
账号大概率开启了两步验证。设置 ARCHERY_TOTP_SECRET 为 Google 身份验证器对应的 base32 密钥(绑定时的那串大写字母,不是实时的六位验证码)。
sql_check 提示"平台检查未执行"?
账号需要在 Archery 系统配置 api_user_whitelist(API 用户白名单)内,并拥有 sql.sql_submit 权限。本地内置规范结果不受影响。
查询被 Archery 拒绝? 检查账号在 Archery 中的资源组、实例与库权限,以及该账号的查询行数限制配置。MCP 会原样返回 Archery 的错误信息。
支持哪些 Archery 版本? 针对 Archery v1.10.0 开发与实测。其他版本的 Web 端点行为未验证,遇到不兼容欢迎提 Issue(附上版本号与脱敏后的错误信息)。
为什么不在 MCP 侧过滤敏感字段? 本地过滤会制造"看起来安全"的错觉,而权限与脱敏的真正执行点在 Archery。MCP 侧重复实现只会两套规则互相打架;把策略收敛到平台一处,审计才有一致的依据。这也是本项目的核心设计决策(详见 docs/ARCHITECTURE.md)。
target → 固定的实例/库/模式组合);itzhouq,独立开发者,在 itzhouq.cn 记录 build in public 日常,做的小工具都收录在工具页。
本项目的开源复盘:让 AI 只读"看见"生产库:archery-mcp 开源复盘
Read-only MCP server for the Archery SQL audit platform: production schema and release SQL checks
{ "mcpServers": { "io.github.itzhouq-archery-mcp": { "command": "uvx", "args": [ "archery-mcp==0.1.1" ], "env": { "ARCHERY_BASE_URL": "<value>", "ARCHERY_USERNAME": "<value>", "ARCHERY_PASSWORD": "<secret>", "ARCHERY_TOTP_SECRET": "<secret>", "ARCHERY_INSTANCE_NAME": "<value>", "ARCHERY_DB_NAME": "<value>", "ARCHERY_SCHEMA_NAME": "<value>", "ARCHERY_QUERY_LIMIT": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: ARCHERY_BASE_URL, ARCHERY_USERNAME, ARCHERY_PASSWORD, ARCHERY_TOTP_SECRET, ARCHERY_INSTANCE_NAME, ARCHERY_DB_NAME, ARCHERY_SCHEMA_NAME, ARCHERY_QUERY_LIMIT
Archery MCP ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 Read-only MCP server for the Archery SQL audit platform: production schema and release SQL checks