Hermes Agent: MCP 协议

# 一行配置，连接 MCP 服务器
hermes mcp add filesystem --command "npx @anthropic/mcp-filesystem /home/alice"
hermes mcp add github --command "npx @anthropic/mcp-github"

# Hermes 自动发现所有可用工具
hermes mcp tools
# 发现 15 个新工具：read_file, write_file, search_files, create_issue...

# ~/.hermes/config.yaml
mcp:
  enabled: true
  
  # MCP 服务器列表
  servers:
    filesystem:
      command: "npx"
      args: ["@anthropic/mcp-filesystem", "/home/alice/projects"]
      
    github:
      command: "npx"
      args: ["@anthropic/mcp-github"]
      env:
        GITHUB_TOKEN: "${GITHUB_TOKEN}"
        
    database:
      command: "python"
      args: ["-m", "mcp_server_postgres"]
      env:
        DATABASE_URL: "${DATABASE_URL}"
        
    brave-search:
      command: "npx"
      args: ["@anthropic/mcp-brave-search"]
      env:
        BRAVE_API_KEY: "${BRAVE_API_KEY}"

# 添加 MCP 服务器
hermes mcp add filesystem --command "npx @anthropic/mcp-filesystem /home/alice"

# 列出已配置的服务器
hermes mcp list

# 测试连接
hermes mcp test filesystem

# 查看服务器提供的工具
hermes mcp tools filesystem

# 移除服务器
hermes mcp remove filesystem

hermes mcp tools

# 输出示例：
# ┌─────────────────────┬──────────────┬────────────────────────┐
# │ Tool                │ Server       │ Description            │
# ├─────────────────────┼──────────────┼────────────────────────┤
# │ read_file           │ filesystem   │ Read file contents     │
# │ write_file          │ filesystem   │ Write to file          │
# │ search_files        │ filesystem   │ Search in files        │
# │ create_issue        │ github       │ Create GitHub issue    │
# │ list_prs            │ github       │ List pull requests     │
# │ query               │ database     │ Execute SQL query      │
# │ search              │ brave-search │ Web search             │
# └─────────────────────┴──────────────┴────────────────────────┘

me: 读取 README.md 的内容
Agent: [MCP: filesystem/read_file]
       # My Project...

me: 在 GitHub 创建一个 Issue
Agent: [MCP: github/create_issue]
       标题？→ "Bug: Login fails on mobile"
       ✅ Issue #42 已创建

me: 搜索最新的 AI 新闻
Agent: [MCP: brave-search/search]
       找到5条结果...

mcp:
  routing:
    # 优先使用 MCP 工具
    prefer_mcp: true
    
    # 同名工具优先级
    priority:
      filesystem.read_file: 100     # MCP 版本优先
      fs_read: 50                   # 内置版本次之
      
    # 冲突解决
    conflict_resolution: "priority"  # priority / server_order / ask_user

# mcp_server_custom.py
from mcp.server import Server, Tool

server = Server("custom-tools")

@server.tool("get_weather")
async def get_weather(city: str) -> dict:
    """Get current weather for a city"""
    # 自定义逻辑
    import httpx
    response = httpx.get(f"https://api.weather.com/{city}")
    return response.json()

@server.tool("send_notification")
async def send_notification(message: str, channel: str = "default") -> dict:
    """Send a notification to a channel"""
    # 自定义通知逻辑
    return {"status": "sent", "channel": channel}

if __name__ == "__main__":
    server.run()

// mcp-server-custom.ts
import { Server, Tool } from "@anthropic/mcp";

const server = new Server("custom-tools");

server.tool("query_database", {
  description: "Query the database",
  parameters: {
    sql: { type: "string", required: true },
    limit: { type: "number", default: 100 }
  },
  async execute({ sql, limit }) {
    // 自定义数据库查询
    const results = await db.query(sql, { limit });
    return { rows: results };
  }
});

server.run();

# 注册自定义 MCP 服务器
hermes mcp add custom-tools \
  --command "python mcp_server_custom.py" \
  --working-dir /path/to/server

# 或配置到 config.yaml

mcp:
  servers:
    custom-tools:
      command: "python"
      args: ["mcp_server_custom.py"]
      working_dir: "/path/to/server"
      env:
        API_KEY: "${CUSTOM_API_KEY}"