Hermes Agent 接入

Hermes Agent 是一款开源 AI Agent 框架，支持 MCP 协议。

配置步骤

1. 找到 Hermes 配置文件：~/.hermes/config.yaml

2. 在 mcp_servers 部分添加 sentinel 配置：

本地 stdio 模式（pip install）

如果你已通过 pip install -e . 安装了 sentinel-mcp-server：

mcp_servers:
  sentinel:
    command: python
    args: ["-m", "sentinel_mcp.server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "你的token"
    enabled: true

本地 stdio 模式（uvx，无需 pip install）

mcp_servers:
  sentinel:
    command: uvx
    args: ["sentinel-mcp-server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "你的token"
    enabled: true

字段	说明
command	用 python（pip 模式）或 uvx（免安装模式）
args	pip 模式用 ["-m", "sentinel_mcp.server"]，uvx 模式用 ["sentinel-mcp-server"]
SENTINEL_API_BASE	API 地址
SENTINEL_TOKEN	你的用户 Token
enabled	设为 true 启用

3. 重启 Hermes Agent

验证

在 Hermes 交互模式中输入 /tools，应看到以下 10 个工具（前缀 mcp__sentinel__）：

mcp__sentinel__get_monitor_list
mcp__sentinel__get_price_summary
mcp__sentinel__get_price_history
mcp__sentinel__get_alerts
mcp__sentinel__add_monitor
mcp__sentinel__update_monitor_status
mcp__sentinel__mark_alert_read
mcp__sentinel__get_crawl_health
mcp__sentinel__get_monitor_overview
mcp__sentinel__search_my_products

或在命令行执行：

hermes mcp list

常见问题

问题	原因	解决
/tools 看不到 sentinel 工具	MCP Server 未加载	检查 config.yaml 配置，执行 /reload-mcp
工具返回 "SENTINEL_TOKEN 未设置"	env 没传进去	确认 env.SENTINEL_TOKEN 写对了
工具返回 401 Unauthorized	Token 无效	换一个有效的 Token
工具返回 500	API 端未部署	确认后端 API 已部署最新版本
command not found: python	Python 不在 PATH	用完整路径如 C:\Python313\python.exe
ModuleNotFoundError: sentinel_mcp	包没装	重新 pip install -e . 或改用 uvx 模式
Hermes 启动卡住	MCP Server 启动超时	手动 python -m sentinel_mcp.server 测试

工具过滤

如果只想暴露部分工具，可使用 allow-list 配置：

mcp_servers:
  sentinel:
    command: uvx
    args: ["sentinel-mcp-server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "你的token"
    enabled: true
    # 只暴露查询类工具
    tool_filter:
      allow:
        - get_monitor_list
        - get_price_summary
        - get_price_history
        - get_alerts