MCP 服务器
一份定义,按目标 agent 生成 JSON、TOML 或 YAML,写入前先看 diff。
更新于 · 2026-11-02
MCP 的定义在每家 agent 里的写法都不一样。AgentHub 让你只维护一份,再按目标格式生成。
格式对照
| 目标 | 文件 | 格式 |
|---|---|---|
| Claude Code / CodeBuddy / Gemini | mcp.json 一类 | JSON |
| Codex | ~/.codex/config.toml | TOML |
| Hermes | ~/.hermes/config.yaml | YAML |
新增一个服务器时只需要填一次命令、参数与环境变量,界面会给出每种格式的预览。
写入流程
- 在列表里新增或修改一条定义。
- 选「生成写入计划」,右侧抽屉列出每个目标文件的 diff。
- 逐条确认后应用,写入前自动备份。
作用域
MCP 定义可以写在全局,也可以只写进某个项目:
agenthub mcp import ./mcp.json --project ~/Code/my-app
桌面端顶部可以切换作用域,切换后列表只显示当前作用域内的定义。项目级定义存放在项目内的 .agenthub/project.json,随仓库一起走。
常见问题
改了定义会立刻影响正在运行的 agent 吗?
不会。配置文件是重新读取时才生效的,正在运行的会话不受影响;新开会话才会加载新配置。
能直接编辑原始文件吗?
可以,但那样绕过了计划与备份。建议至少在这类改动上走一次计划流程,出问题时才有批次可回滚。