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 服务器

完整示例

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 示例

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

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-<server>
hermes chat --toolsets "mcp-github,mcp-filesystem"

自定义 MCP 服务器

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

1.实现 MCP 协议

2.在 config.yaml 中配置

3.工具自动可用

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

故障排除