10. MCP插件与技能扩展

来源：TraeCode

10.1 前提

完成第 4～5 章后，data/ledger.db 有三条固定九月账目，summary 通过验收。安装本课固定的官方 Python MCP SDK mcp==1.26.0，把 ledger_readonly_mcp.py 复制到项目 scripts/。

10.2 配置一个 stdio MCP

在 CLI 2.0 的 ~/.trae/traecli.toml 增加以下条目。先用 python -c "import sys; print(sys.executable)" 找到虚拟环境解释器，并替换三个绝对路径；Windows 可用 TOML 单引号保存反斜杠路径。

[mcp_servers.ledger_readonly]
command = "/absolute/path/.venv/bin/python"
args = ["/absolute/path/scripts/ledger_readonly_mcp.py", "/absolute/path/data/ledger.db"]

重开会话后用 /mcp 核对服务和工具列表。只应暴露 monthly_totals。调用 2026-09，期望收入 800000 分、支出 4700 分。服务使用 SQLite mode=ro 和 query_only，不靠工具名字包含 write 与否判断权限。独立尝试同一连接执行 INSERT 必须得到 readonly 错误。

10.3 服务端与客户端不能混淆

gh api mcp 不是 MCP 服务；gh api 是 HTTP API 客户端。需要 GitHub 能力时另行按 GitHub 官方 MCP server 配置，分别验证初始化、工具列表、认证与只读调用，不复用不存在的 stdio 协议。

本章先完成一条账本查询闭环。插件、传输和字段全集只在需要时查官方参考；/plugins、/skills、/mcp 是不同管理入口，避免为了介绍功能而加入无关配置。

参考：CLI 2.0 配置、工具与扩展。