use-mcp-with-hermes

使用 MCP 与 Hermes

什么是 MCP？

MCP（Model Context Protocol，模型上下文协议）是一种允许 LLM 智能体连接外部工具服务器的开放协议。Hermes 原生支持 MCP。

配置 MCP 服务器

# ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
  filesystem:
    url: "https://mcp.example.com/v1/mcp"
    headers:
      Authorization: "Bearer ${TOKEN}"

CLI 管理

hermes mcp add myserver --url https://...
hermes mcp add myserver --command npx --args "package"
hermes mcp list             # 列出配置的服务器
hermes mcp test myserver    # 测试连接
hermes mcp configure name   # 选择工具

传输方式

• Stdio：本地命令（推荐，低延迟）
• HTTP/StreamableHTTP：远程服务器
• 同一服务器可根据通信类型配置不同的超时

注意事项

• MCP 工具在 /reset 后才能在会话中使用
• 添加 MCP 服务器后需要 /reload-mcp 或重启
• 环境变量可在 env 字段中配置，引用 .env 中的值

详见 workspace zh/guides/use-mcp-with-hermes.md