SuperAPI AI 工具集

native-mcp

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:Hermes Agent 内置 MCP(Model Context Protocol)客户端,在启动时连接外部 MCP 服务器、发现其工具,并作为一等工具供智能体直接调用,无需桥接 CLI。适用于接入文件系统、GitHub、数据库、API 等外部能力,支持本地 stdio 服务器(npx、uvx 或任意命令)与远程 HTTP/StreamableHTTP 服务器。若只需终端中临时一次性调用 MCP 工具,应改用 mcporter 技能。

主要能力:启动时读取 ~/.hermes/config.yaml 的 mcp_servers,连接服务器、调用 list_tools() 发现工具并注册;工具命名规则为 mcp_{server_name}_{tool_name},名称中的连字符与点替换为下划线;发现后自动注入所有 hermes-* 平台工具集(CLI、Discord、Telegram 等),每个会话均可用。连接以长驻 asyncio 任务运行于后台守护线程,断线自动重连(指数退避,最多 5 次,上限 60 秒),进程关闭时优雅断开;discover_mcp_tools() 幂等,失败服务器会在后续调用中重试。

使用方式:先安装可选依赖 pip install mcp(或 uv pip install mcp),未安装则 MCP 支持静默禁用;npx 服务器需 Node.js,uvx 服务器需 uv。在配置中为每个服务器指定 command(stdio)或 url(HTTP),二者不可同时使用;可选 args、env、headers、timeout(默认 120 秒)、connect_timeout(默认 60 秒)。修改服务器需重启智能体,当前无热重载。

限制与安全:stdio 子进程仅继承 PATH、HOME、USER、LANG、LC_ALL、TERM、SHELL、TMPDIR 及 XDG_* 等安全变量,其他环境变量(密钥、令牌)默认不传递,需通过 env 显式添加;错误信息中的凭据样式(如 ghp_、sk-、Bearer、token=、key=、API_KEY=、password=、secret=)会被自动脱敏。HTTP 传输需所装 mcp 版本包含 mcp.client.streamable_http,否则该服务器报 ImportError 而其他服务器不受影响。工具结果以 JSON 返回 {"result": "..."} 或 {"error": "..."}。原生 MCP 客户端与 mcporter 相互独立,可同时使用。具体收费、价格与效果资料暂未提供。