Hermes Agent MCP 集成

Model Context Protocol（MCP）是一个开放标准，允许 AI 智能体连接到外部工具和服务。Hermes 支持 MCP，允许您扩展其功能。

通过 MCP，Hermes 可以连接到 GitHub、文件系统、数据库等任何 MCP 服务器——安全、可扩展。

什么是 MCP？

Model Context Protocol（MCP）是一个标准化协议，允许 AI 智能体：

  • 发现并使用外部工具
  • 访问远程资源
  • 与外部系统交互

MCP 服务器可以提供文件系统访问、数据库查询、API 集成等功能。

配置 MCP 服务器

基本配置

在 ~/.hermes/config.yaml 中添加 MCP 服务器：

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

常用 MCP 服务器

服务器 功能 安装命令
GitHub 仓库管理、PR、Issues npx -y @modelcontextprotocol/server-github
Filesystem 文件操作 npx -y @modelcontextprotocol/server-filesystem
PostgreSQL 数据库查询 npx -y @modelcontextprotocol/server-postgres
Brave Search 网页搜索 npx -y @modelcontextprotocol/server-brave-search
Slack Slack 集成 npx -y @modelcontextprotocol/server-slack

完整示例

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"

  filesystem:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

  postgres:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      DATABASE_URL: "postgresql://user:pass@localhost/db"

使用 MCP 工具

配置 MCP 服务器后，工具会自动可用：

# 列出可用工具
hermes
❯ /tools

MCP 工具会以 mcp-<server>-<tool> 格式显示。

GitHub 示例

❯ 创建一个新的 GitHub issue

Hermes 会使用 MCP GitHub 服务器来：

  • 创建 issue
  • 添加标签
  • 分配给适当的开发者

过滤 MCP 工具

可以使用 allowed_tools 或 blocked_tools 来过滤工具：

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
    allowed_tools:
      - github_list_issues
      - github_create_issue
      - github_get_issue
    blocked_tools:
      - github_delete_repository
安全建议：始终限制允许的工具，特别是对于具有敏感操作的服务器如 GitHub（删除操作）或文件系统（删除操作）。

MCP 工具集

MCP 工具作为工具集自动添加到 Hermes：

# MCP 工具集自动命名为 mcp-&lt;server&gt;
hermes chat --toolsets "mcp-github,mcp-filesystem"

自定义 MCP 服务器

您可以创建自己的 MCP 服务器来扩展 Hermes：

  1. 实现 MCP 协议
  2. 在 config.yaml 中配置
  3. 工具自动可用

有关创建 MCP 服务器的详细信息，请参阅 MCP 规范。

故障排除

问题 解决方案
MCP 工具不可用 检查配置并重新启动 Hermes
权限错误 验证 API 密钥和环境变量
连接超时 检查网络和服务器状态
工具执行失败 查看详细日志

提示：使用 hermes doctor 可以诊断 MCP 配置问题。