协议
Hermes Agent MCP 中文指南
MCP（Model Context Protocol，模型上下文协议）是 Anthropic 推出的“让 LLM 调用外部工具”的标准化协议。Hermes Agent 2026 年起原生支持 MCP，可以装社区生态里几百个现成的 MCP Server。本文讲怎么装、怎么用、和 Hermes Skills 的区别。
MCP 是什么
MCP 是 Anthropic 在 2024 年底推出、2025 年被 OpenAI/Google/Hermes 普遍接受的标准。核心思想：
- LLM 的“工具”不再写死在框架里，而是“独立进程”通过标准协议暴露
- 一个 MCP Server 用 stdio 或 HTTP 启动，自我描述能做什么（tools / resources / prompts）
- Hermes 在启动时把所有 MCP Server 的能力 merge 进可用工具列表，LLM 按需调用
简单说：MCP 让“Hermes 能用浏览器”、“Hermes 能查 GitHub”、“Hermes 能拉 npm 文档” 变成插件化的事 —— 不用改 Hermes 代码。
装一个 MCP Server
# 装 GitHub MCP Server
hermes mcp install @modelcontextprotocol/server-github
# 装 chrome-devtools（让 Hermes 能开浏览器）
hermes mcp install chrome-devtools-mcp
# 装 Context7（实时拉库文档）
hermes mcp install @upstash/context7-mcp
# 列已装的 MCP servers
hermes mcp list
# 卸载
hermes mcp remove chrome-devtools-mcp装完 Hermes 自动 reload，下次对话 LLM 就能看到新工具了。
手工配置 mcp.json
或者直接编辑 ~/.hermes/mcp.json：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
},
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp"]
}
}
}常用 MCP Server 推荐
| Server | 干什么 |
|---|---|
| chrome-devtools-mcp | 让 LLM 开浏览器、点击、截图、跑 Lighthouse |
| @modelcontextprotocol/server-github | 查 issues / PRs、创建 PR、读代码 |
| @upstash/context7-mcp | 实时拉 npm/PyPI 库文档，避免训练数据过期 |
| playwright-mcp | 跨浏览器自动化（比 chrome-devtools 更通用） |
| @modelcontextprotocol/server-postgres | 查 PostgreSQL 数据库 |
| @modelcontextprotocol/server-filesystem | 读写指定目录（chrooted） |
MCP vs Hermes Skills 的区别
| MCP Server | Hermes Skill | |
|---|---|---|
| 形态 | 独立进程，标准协议 | SKILL.md + 脚本，文件目录 |
| 跨工具复用 | 是（Claude Desktop / Cursor / Hermes / Codex 都能用） | 否（仅 Hermes / Claude Code 兼容） |
| 启动方式 | npx / docker，需要进程管理 | 纯文件，没进程 |
| 性能 | 每个 Server 一个进程，占资源 | 零开销 |
| 触发逻辑 | LLM 看 tool schema 决定调 | LLM 看 description 决定用 |
| 适合 | 复杂能力（浏览器、DB、IDE） | 简单流程（写邮件、查天气、跑脚本） |
一般 Hermes 实例里两个都装：MCP 提供“能力底座”（浏览器、DB），Skill 提供“任务封装”（“每周一发周报”）。
排错
装了 MCP，LLM 不调用
- 检查
hermes mcp list是否显示状态为running - 看
~/.hermes/logs/mcp/<name>.log是否有 startup 报错 - 确认 LLM 模型支持 tool calling（GPT-4 / Claude Sonnet 4+ / Gemini 2 Pro 全部支持；Llama 3.1 70B 以下可能识别不到 tool schema）
MCP Server 启动失败
- npx 拉超时 —— 装 npm cache mirror 或预先
npm install -g - 缺环境变量（如
GITHUB_PERSONAL_ACCESS_TOKEN）—— 在 mcp.json 里 env 字段补 - 权限不足（如 filesystem MCP）—— 容器里允许读写的目录要 mount
多个 MCP 工具冲突
比如同时装了 chrome-devtools 和 playwright-mcp，两个都能截屏。LLM 可能随机选。解决：卸掉一个，或者在 Skill 里写“截屏优先用 playwright”。
Hermes on OpenClaw Launch 怎么用 MCP
托管 Hermes 预装了 chrome-devtools-mcp、context7、playwright 等常用 MCP。Dashboard 里可以加装其他社区 MCP，不用 SSH 进容器。需要环境变量的 MCP（如 GitHub），在 Dashboard 的 Env 标签里加。