这一类工具装起来最快、翻车最安静:SQL 跑通了、图也出了、数字是错的,全程没有一条红色报错。所以本期先给十条能装的,再给一套专治「静默出错」的验货判据。
写作类 skill 装错了,你一眼看得出来;数据类装错了,你看到的是一个格式漂亮的数字。这一类的失败模式是静默的——列名选错、口径取错、过滤条件漏了一条,SQL 照样返回一行结果。更麻烦的是,能救这件事的东西不在任何 marketplace 里:你公司管「活跃用户」叫什么,只有你知道。本期点名十条真实可装的条目(官方插件市场里的、GitHub 上的、官方 skill 里的各占一部分),先给表和命令,后半程再给在它们之间取舍的判据。
# ①②③ 官方市场,Claude Code 首次交互启动时自动添加;没有就手动加
/plugin marketplace add anthropics/claude-plugins-official
/plugin install duckdb-skills@claude-plugins-official
/plugin install bigquery-data-analytics@claude-plugins-official
/plugin install clickhouse@claude-plugins-official
/plugin install clickhouse-best-practices@claude-plugins-official
# ④ 二进制 / brew / npm 三种装法,配置在 tools.yaml
brew install mcp-toolbox
npx -y @toolbox-sdk/server --prebuilt=postgres --stdio # 先拿预置工具试水
./toolbox --config "tools.yaml" # 正式用法:自己定义工具
# ⑤ 生产库务必带 restricted:只读事务 + 执行时间上限
pipx install postgres-mcp
postgres-mcp --access-mode=restricted
# ⑥ 一个网关连 Postgres/MySQL/SQL Server/MariaDB/Oracle/SQLite
npx @bytebase/dbhub@latest --transport http --port 8080 \
--dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
# ⑦ 不给 token 就是纯本地 DuckDB;只读就别加 --read-write
uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases
# ⑧ 默认走它的公共出图服务,介意就自部署后指 VIS_REQUEST_SERVER
npx -y @antv/mcp-server-chart
# ⑨ 官方文档四件套:xlsx / docx / pptx / pdf 一起装
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
# ⑩ 先起 JupyterLab,再挂 MCP
uvx jupyter-mcp-server@latest
# 装完立刻做这件事
/skill-doctor # 看每个 skill 的 context 成本与调用频次
CLICKHOUSE_ALLOW_WRITE_ACCESS=false)。tools.yaml 里把「月活怎么算」定义成一个带参数的工具,模型只能调它,编不出第二种算法。覆盖 AlloyDB、BigQuery、Cloud SQL、Spanner、Postgres、MySQL、SQL Server、Oracle、MongoDB、Redis、ClickHouse、Snowflake、Trino 等。什么时候别装:你只是临时查一次——写 YAML 的成本比那次查询高。EXPLAIN 加假设索引模拟(不真建索引就估收益)。两档权限写得很清楚:unrestricted 给开发机,restricted 是只读事务加执行时间上限、给生产。生产库上没有第二个选项。execute_sql、search_objects,explain_sql 与 health_check 要显式开;还能配自定义参数化 SQL 工具(和④同一个思路的轻量版)。README 明写护栏是「只读模式、行数上限、查询超时」三件套;诚实交代:它的参数文档站本期被出口策略挡住,确切 flag 名本期不抄,装前自己看它的 Command-Line Options 页。VIS_REQUEST_SERVER 指过去;地图类图表依赖高德,只在中国境内可用。document-skills 插件里):产出层里最该装的一个,因为它把「不坏文件」写成了硬规矩——必须写公式而不是把 Python 算出的结果硬编进去;写完公式必须跑 scripts/recalc.py(调 LibreOffice 真算一遍),报告 errors_found 不为零就不许交付;XLOOKUP / FILTER / UNIQUE 这类明令禁用(LibreOffice 算不了),改用 INDEX/MATCH。最值得抄进你自己规范的一条:所有假设与硬编码数字必须用单元格批注写明出处。duckdb 加一个 Bash 就够了。最常见的装法是只装中间两层:连上了库、出得了图,然后每次问同一个指标得到不一样的数。原因不在模型笨,在于它面对的是一个有几千列、没人写过定义的库。企业级 text-to-SQL 的基准 Spider 2.0(ICLR 2025 Oral)把这件事量化了:据其仓库 README(论文口径,2024-11),当时最强的 LLM 在 Spider 2.0 上只解出 6.0%,而同样的模型在 Spider 1.0 上是 86.6%、BIRD 上是 57.4%。三个数放一起才是重点——不是模型不会写 SQL,是真实企业库里「问题→SQL」这一步本来就没有唯一解。(该基准 2026 年榜上的分数已经显著高于这个数;其官网本期被出口策略挡住,未能核现值,故只给论文口径的原数与日期。)
所以这一类的选型顺序和别的类别是反的:先决定口径写在哪,再挑工具。三条真实可走的路,都在上面点过名:④ 的 tools.yaml——把指标定义成带参数的工具,模型只能调、不能改算法;⑥ 的自定义参数化 SQL 工具——同一思路的轻量版;已经有 Looker 的直接用官方 looker 插件,LookML 本身就是一份可执行的口径。三条都走不了,就退到最土的一条:在 CLAUDE.md 里写死几条口径与禁用表,再让 ⑨ 的规矩替你留痕——假设必须写成批注。
⑧⑨ 之所以单列一层,是因为它们只管「好不好看 / 坏不坏文件」,完全不管数字对不对。一张桑基图可以把错误的口径画得非常专业。
--access-mode=restricted 给只读事务加执行时间上限)与 mcp-clickhouse(CLICKHOUSE_ALLOW_WRITE_ACCESS 默认 false);⑦ 的写权限是你自己加 --read-write 加上去的;mcp-alchemy 这一格是空的。SELECT * 就能把上下文窗口和数据库连接池一起打满。⑥ 明写有这两道护栏。search_objects、③ 的浏览表结构)?几千列的库用前一种,等于每轮都在烧钱。looker 这一格是实的。其余的都指望模型每次现编,而它每次都可能编得不一样。tools.yaml 它就退化成一个普通的 SQL 网关。按你缺哪一层挑,不按榜位挑。/skill-doctor,看谁在白拿钱。DELETE 当成清洗步骤跑了,这件事没有撤销键。只读是默认值,不是可选项。xlsx skill。 不连任何库,也就没有任何权限风险,而它的公式校验闭环照样生效。duckdb CLI 加 Bash 就是执行层。 ① 的价值主要在便利和文档检索,不在能力。CLAUDE.md,连表名和禁用表一起写死——这一步比装任何一个 server 都值钱,而且零成本。先装这三个:① /plugin install duckdb-skills@claude-plugins-official——本地文件立刻能查,零权限风险。② 连你的库那一个,按库挑:Postgres 用 pipx install postgres-mcp 并务必带 --access-mode=restricted;杂库用 npx @bytebase/dbhub@latest;已经在 BigQuery / ClickHouse 上的直接装官方 bigquery-data-analytics / clickhouse。③ /plugin install document-skills@anthropic-agent-skills——让结果落成公式不坏、假设有批注的 .xlsx。
按需再加:googleapis/genai-toolbox(要把指标口径钉成工具,愿意写 tools.yaml)· antvis/mcp-server-chart(要出图,且接受数据出网或自己部署 VIS_REQUEST_SERVER)· clickhouse-best-practices(你在写 ClickHouse 表)· datalayer/jupyter-mcp-server(你本来就住在 notebook 里)· ClickHouse/mcp-clickhouse(自托管 ClickHouse)· 官方 looker(你已经有 LookML)。
明确别做:给生产库开写权限 · 同一个库同时接两个 server · 把整库 schema 一次性灌进 context · 用 mcp-alchemy 这类没有只读开关的连生产库 · 照着老教程装官方 reference 里早已不存在的 postgres / sqlite server · 以为装完这十条,口径问题就解决了。
errors_found 不为零就不许交付。duckdb-skills(DuckDB Foundation)、bigquery-data-analytics / looker(Google LLC)、clickhouse / clickhouse-best-practices(ClickHouse)的名字与作者均以此处 marketplace.json 为准(2026-09)/plugin install <name>@claude-plugins-official;详情页会显示 Context cost 与 Last updated(2026-09)tools.yaml;brew install mcp-toolbox 与 --prebuilt=postgres --stdio;自定义工具=受限访问 + 结构化查询(据仓库页,2026-09 为 16.5k 星,Apache-2.0)--access-mode=restricted|unrestricted(据仓库页,2026-09 为 3.3k 星,MIT)execute_sql / search_objects,explain_sql 与 health_check 需显式开;自定义参数化 SQL 工具(据仓库页,2026-09 为 3.6k 星,MIT)VIS_REQUEST_SERVER 自部署;地图依赖高德、仅中国境内(据仓库页,2026-09 为 4.4k 星,MIT)scripts/recalc.py 与 errors_found;禁用 XLOOKUP/FILTER/UNIQUE;假设写成单元格批注