Hermes Agent + MCP (Model Context Protocol) 研究报告

v1.0 发布日期: 2026年4月12日 | 最后更新: 2026-03-12 | Hermes Agent v0.2.0

MCP 协议详解：为何 AI 智能体需要标准接口？

Hermes Agent：58K+ Stars 的 AI 智能体框架

📊 目录

项目概述
MCP 协议详解
Hermes Agent 核心功能
MCP 集成特性
配置指南
实际应用场景
部署与发布
社区与生态
未来展望
附录

1. 项目概述

Hermes Agent 是 Nous Research 构建的 AI 能力框架，支持通过 MCP 与外部工具生态连接。

1.1 生态数据速览

指标	数据
GitHub Stars	58K+
核心贡献者	63+ 人
MCP 服务器注册量	10,000+
月下载量	9700 万次
内置技能	70+ 个
测试规模	3,289+ 单元测试
支持消息平台	8+ (Telegram、Discord、Slack 等)

1.2 核心价值

✅ 无缝集成 - 无需为任何工具编写原生 Hermes 代码
✅ 细粒度权限 - 单独过滤/白名单每个服务器工具
✅ 统一配置 - 本地 stdio 和远程 HTTP 服务器在同一配置
✅ 安全性 - 环境变量过滤，防止敏感信息泄露
✅ 双向连接 - 既是 MCP 客户端，也是 MCP 服务器

2. MCP 协议详解

2.1 协议起源

提出者: Anthropic (2024年11月)
捐赠方: Linux Foundation (2024年12月)
当前规范版本: 2025-11-25

2.2 协议架构


         LLM 应用 (Hermes Agent)
               │
        ┌──────┴──────┐
        │             │
   STDIO        HTTP  (Streamable HTTP)
        │             │
        ▼             ▼
   ┌──────────────────────────┐
   │      MCP Server           │
   │ GitHub | Filesystem | DB  │
   └──────────────────────────┘

2.3 核心特征

tools/list - 列出可用工具
tools/call - 调用工具
resources/list - 列出可读资源
resources/read - 读取资源
prompts/list - 列出提示模板
prompts/get - 获取提示
experimental.tasks - 异步任务（实验性）

2.4 生态规模

截至2026年初：

10,000+ MCP 服务器 在生产环境运行
> 500 MCP 客户端 支持（Claude、ChatGPT、Cursor 等）
9700 万 SDK 下载/月

3. Hermes Agent 核心功能

3.1 Agent 架构

两层工具发现：全量扫描 → 候选细化
双向互联：MCP 客户端 + MCP 服务器
统一提供者路由：call_llm() API
持久化会话：记忆系统

3.2 多平台消息网关

平台	特性
Telegram	文件附件、PDF/Office 文档
Discord	频道标题、Bot 过滤
Slack	App mention、结构化日志
WhatsApp	原生媒体发送、多用户隔离
Signal	完整网关、媒体 URL
Email (IMAP/SMTP)	新支持
Home Assistant	REST + WebSocket

4. MCP 集成特性

4.1 stdio vs HTTP

# stdio 服务器（本地）
mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

# HTTP 服务器（远程）
mcp_servers:
  remote_api:
    url: "https://mcp.example.com/mcp"
    headers:
      Authorization: "Bearer ***"

4.2 工具命名约定

MCP 工具	注册名称
`read_file`	`mcp_filesystem_read_file`
`create-issue`	`mcp_github_create_issue`
`query data`	`mcp_my_api_query_data`

4.3 白名单策略

github:
  command: "npx"
  args: ["-y", "@modelcontextprotocol/server-github"]
  env:
    GITHUB_PERSONAL_ACCESS_TOKEN: "***"
  tools:
    include: [create_issue, list_issues, search_code]  # 只暴露这些
    exclude: []

4.4 安全特性

环境变量过滤（只传递安全基线）
配置级白名单/黑名单
自动重连（指数退避，最多5次）
工具过滤防止意外访问

5. 配置指南

5.1 基础配置结构

providers:
  openai:
    api_key: ${OPENAI_API_KEY}
    base_url: https://api.openai.com/v1

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

5.2 安全白名单示例

# GitHub - 只创建和列出问题
github:
  tools:
    include: [create_issue, list_issues, update_issue]

# Stripe - 删除操作黑名单
stripe:
  tools:
    exclude: [delete_customer, refund_payment]

# 内部 API - 侧重只读
internal_api:
  tools:
    include: [list_customers, get_customer]

5.3 手动重新加载

/reload-mcp

修改配置后，在会话中运行此指令重新加载 MCP 工具。

6. 实际应用场景

场景 1: 本地项目助手

git:
  command: "uvx"
  args: ["mcp-server-git", "--repository", "/home/user/project"]

# 用法:
Confirm the repository structure and explain the directory layout.

场景 2: GitHub 问题管理助手

github:
  tools:
    include: [create_issue, list_issues, update_issue]

# 用法:
Summarize the common bug patterns in GitHub issues.

场景 3: 内部 API 助手（只读）

internal_api:
  tools:
    include: [list_customers, get_customer]
  resources: false

# 用法:
Check customer ACME Corp's recent invoice activity.

场景 4: 多系统工作流

# 文件系统 + GitHub 结合
# 用法:
List the files in my project, then create a GitHub issue summarizing what you found.

7. 部署与发布

7.1 安装 Hermes Agent

# 标准安装
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 手动安装
cd ~/.hermes/hermes-agent
uv pip install -e ".[all]"

7.2 常见 MCP 服务器

服务器	包名	功能
Filesystem	@modelcontextprotocol/server-filesystem	读写指定目录
GitHub	@modelcontextprotocol/server-github	仓库访问、问题、PR
Postgres	@modelcontextprotocol/server-postgres	PostgreSQL 查询
Brave Search	@modelcontextprotocol/server-brave-search	Web 搜索

7.3 Hermes 作为 MCP 服务器

# 启动 MCP 服务器模式
hermes mcp serve

# 配置到 Claude Desktop
{
  "mcpServers": {
    "hermes": {
      "command": "hermes",
      "args": ["mcp", "serve"]
    }
  }
}

# 可用工具:
# conversations_list, conversation_get, messages_read,
# attachments_fetch, events_poll, events_wait,
# messages_send (), channels_list, permissions_list_open, permissions_respond

8. 社区与生态

8.1 主要贡献者

@teknium1 - 首席开发者，核心架构
@0xbyt4 - MCP 客户端，安全修复，测试套件
@Farukest - 安全加固，Windows 兼容性
@aydnOktay - 原子写入，错误处理

8.2 内置技能（部分）

ASCII Art/pyfiglet (571 字体)
DuckDuckGo 搜索
Solana 区块链
AgentMail
Polymarket 预测市场
Domain Intelligence

8.3 有用资源

主网站: https://hermes-agent.nousresearch.com
MCP 指南: MCP 使用指南
API 参考: API 参考
GitHub: 立即参与

9. 未来展望

9.1 MCP 协议演进

标准化的数据链路
工具可信评估标准
行业标准伙伴关系
资源接口标准化
MCP 生态目录

9.2 Hermes Agent 增强

工具响应缓存
内置异步支持
更多预置 MCP 服务器
IDE 深度集成
CI/CD 集成

9.3 社区增长

公开技能库扩大
付费技能市场
企业托管方案
策略支持
MCP 生态标准化

附录

A. 快速参考

MCP: Model Context Protocol
STDIO - 本地进程通信
HTTP - 远程通信（推荐）
Tool - 可被 Agent 调用的函数
Resource - 可读的结构化数据
Prompt - 预构建提示模板
Gateway - 消息平台连接层
Skill - 可重用的功能模块

B. 技术栈速查

# 使用 npx 运行 Node.js MCP 服务器
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

# 使用 uvx 运行 Python MCP 服务器
command: "uvx"
args: ["mcp-server-git", "--repository", "/home/user/project"]

# HTTP 端点
url: "https://mcp.example.com/mcp"
headers:
  Authorization: "Bearer ***"

C. 环境变量示例

# .env 文件
OPENAI_API_KEY=sk-...
OPENROUTER_API_KEY=sk-...
GITHUB_TOKEN=ghp_...
BRAVE_API_KEY=bsr_...
INTERNAL_API_TOKEN=***

D. 常见问题

Q: MCP 和 Hermes 的关系？
A: MCP 是互联标准；Hermes 支持客户端/服务器模式。
Q: 如何限制工具权限？
A: 白名单策略（tools.include）。
Q: 如何部署为 MCP 服务器？
A: 运行 `hermes mcp serve` 并在目标平台配置。
Q: 推荐的 MCP 服务器？
A: Filesystem、GitHub、Postgres、Brave Search。