dothething接入MCP服务器实战:扩展AI Agent工具能力的完整配置指南

原创2026-10-23 10:08:161,982 阅读

dothething接入MCP服务器实战:扩展AI Agent工具能力的完整配置指南

dothething(DTT)是一个本地运行的自主 AI Agent:你用自然语言描述任务,它自己规划、搜索、执行,直到交付结果。内置工具虽然已覆盖文件操作、网页浏览、Shell 命令等场景,但通过接入 MCP(Model Context Protocol)服务器,你可以把它的能力无缝扩展到数据库、日历、GitHub、SaaS 平台等任意外部系统——这正是本文要解决的完整配置问题。

dothething 自主 AI Agent 架构示意:中心 Agent 连接搜索、文件、管理等工具模块,MCP 服务器可进一步扩展其工具能力

一、MCP 是什么?为什么 AI Agent 都需要它

简单理解:MCP 就是 AI Agent 的"USB 接口"。

  • 每个 MCP 服务器就是一个"外设":数据库服务器、邮件服务器、地图服务……
  • Agent 启动时自动发现服务器暴露的所有工具,像调用内置工具一样调用它们
  • 一套标准协议,跨项目通用:你在 Claude Code 里写好的 MCP 配置,可以直接复用到 dothething

对新手来说最大的好处是:不用写任何胶水代码。配置一个 JSON 文件,Agent 立刻"长出"新工具。

二、dothething 的 MCP 内置机制:三行讲清楚

dothething 从架构层面就支持 MCP,核心逻辑在 dtt.sh 的 MCPManager 中:

  1. 启动时读取 ~/.dtt/mcp.json(与 Claude Code 完全相同的格式),逐一连接其中声明的 MCP 服务器
  2. 自动发现工具:每个 MCP 工具被注册为 mcp__服务器名__工具名,例如 mcp__github__create_issue,并注入系统提示词供模型直接调用
  3. 热更新:运行中修改配置或增删服务器,无需重启 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 装上"外设"

回顾整个流程其实只有三步:

  1. 在 ~/.dtt/mcp.json 中按 Claude Code 格式声明服务器
  2. 密钥用 ${变量} 引用,存入 ~/.dtt/env
  3. 启动 dtt,或直接让它通过 manage_mcp 自己接入

dothething 的完整能力清单(含 Skills 技能扩展、邮件、剪贴板等)可参考 README.md,许可协议见 LICENSE。

💡 上手建议:先从一个轻量服务器(如文件系统、SQLite)开始跑通全流程,再逐步接入带 API 密钥的正式服务,问题最好定位。

登录后查看全文
dothething