dothething接入MCP服务器实战:扩展AI Agent工具能力的完整配置指南
dothething接入MCP服务器实战:扩展AI Agent工具能力的完整配置指南
dothething(DTT)是一个本地运行的自主 AI Agent:你用自然语言描述任务,它自己规划、搜索、执行,直到交付结果。内置工具虽然已覆盖文件操作、网页浏览、Shell 命令等场景,但通过接入 MCP(Model Context Protocol)服务器,你可以把它的能力无缝扩展到数据库、日历、GitHub、SaaS 平台等任意外部系统——这正是本文要解决的完整配置问题。
一、MCP 是什么?为什么 AI Agent 都需要它
简单理解:MCP 就是 AI Agent 的"USB 接口"。
- 每个 MCP 服务器就是一个"外设":数据库服务器、邮件服务器、地图服务……
- Agent 启动时自动发现服务器暴露的所有工具,像调用内置工具一样调用它们
- 一套标准协议,跨项目通用:你在 Claude Code 里写好的 MCP 配置,可以直接复用到 dothething
对新手来说最大的好处是:不用写任何胶水代码。配置一个 JSON 文件,Agent 立刻"长出"新工具。
二、dothething 的 MCP 内置机制:三行讲清楚
dothething 从架构层面就支持 MCP,核心逻辑在 dtt.sh 的 MCPManager 中:
- 启动时读取
~/.dtt/mcp.json(与 Claude Code 完全相同的格式),逐一连接其中声明的 MCP 服务器 - 自动发现工具:每个 MCP 工具被注册为
mcp__服务器名__工具名,例如mcp__github__create_issue,并注入系统提示词供模型直接调用 - 热更新:运行中修改配置或增删服务器,无需重启 Agent
另外,MCP 工具与内置工具一视同仁:支持 result_mode(让 worker 模型先做摘要、节省上下文)和 exec_order(多工具分阶段并行执行)等调度能力,见 dtt.sh。
三、一键接入步骤:从 0 到可用的 MCP 配置
第 1 步:创建配置文件
MCP 服务器统一配置在 ~/.dtt/mcp.json。没有这个文件?直接新建一个即可,~/.dtt/ 目录不存在时会自动创建。
第 2 步:按标准格式声明服务器
官方给出的标准格式(来自 README.md):
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["-y", "my-mcp-server"],
"env": { "API_KEY": "${MY_API_KEY}" }
}
}
}
三个字段对应"怎么启动这个服务器":
| 字段 | 含义 | 示例 |
|---|---|---|
command |
启动命令 | npx、uvx、python |
args |
命令参数列表 | ["-y", "my-mcp-server"] |
env |
传给服务器环境变量,支持 ${变量} 展开 |
{"API_KEY": "${MY_API_KEY}"} |
第 3 步:启动 dtt 验证连接
dtt --prompt "列出当前可用的 MCP 工具"
启动时你会看到 MCP: connecting my-server... 和 MCP: my-server connected (N tools) 的提示;连不上则打印 ⚠ MCP server 'my-server' failed: ... 便于排查。单次连接超时 30 秒,不会卡住整个启动流程。
四、MCP 配置进阶技巧(新手最常踩的 3 个点)
技巧 1:密钥别硬编码,用变量展开
env 字段支持 ${VAR} 和 ${VAR:-默认值} 两种占位符语法(实现见 dtt.sh)。把密钥放进环境变量或 ~/.dtt/env,配置文件里只留变量名,避免明文泄露。
技巧 2:运行中让 Agent 自己添加服务器
dothething 提供 manage_mcp 工具,支持 add / remove / list 三种操作,修改后自动热重载连接,无需重启会话。更妙的是密钥处理:env 中检测到 KEY、TOKEN、SECRET、PASSWORD 等字样的变量会被自动存入 ~/.dtt/env(变量名形如 MCP_服务器名_密钥名),配置文件中只保留引用(实现见 dtt.sh)。
也就是说,你只需对 Agent 说一句:
"帮我接入 GitHub 的 MCP 服务器,token 用 XXX"
它会自己完成 ~/.dtt/mcp.json 的写入、密钥归档和连接验证。
技巧 3:了解安全隔离设计
出于安全考虑,dothething 只把 PATH、HOME 和你在配置中显式声明的环境变量传给 MCP 服务器(见 dtt.sh)——OPENROUTER_API_KEY 等敏感密钥不会被连带泄露,这也是可以放心接入第三方服务器的原因之一。
五、常见问题速查
| 问题 | 排查方向 |
|---|---|
启动后工具列表里没有 mcp__ 开头的工具 |
检查 ~/.dtt/mcp.json 的 JSON 格式是否合法、command 是否可执行 |
提示 Connection timed out after 30s |
服务器依赖未安装,先用 command + args 手动跑一次确认 |
| 工具能发现但调用报错 | 多数是 env 中密钥未生效,确认对应变量已写入 ~/.dtt/env 或 shell 环境 |
| 想临时移除某个服务器 | 对 Agent 说"移除 xx 的 MCP 服务器",manage_mcp 会热更新 |
六、小结:5 分钟给你的 Agent 装上"外设"
回顾整个流程其实只有三步:
- 在
~/.dtt/mcp.json中按 Claude Code 格式声明服务器 - 密钥用
${变量}引用,存入~/.dtt/env - 启动
dtt,或直接让它通过manage_mcp自己接入
dothething 的完整能力清单(含 Skills 技能扩展、邮件、剪贴板等)可参考 README.md,许可协议见 LICENSE。
💡 上手建议:先从一个轻量服务器(如文件系统、SQLite)开始跑通全流程,再逐步接入带 API 密钥的正式服务,问题最好定位。
