SuperAPI AI 工具集

native-mcp

智能体与模型

查看项目

更新于 10-16 02:33

技能介绍

用途:Hermes Agent 内置的 MCP 客户端,在启动时连接 MCP 服务器、发现其工具,并作为一等工具供智能体直接调用,无需桥接 CLI。适用于接入文件系统、GitHub、数据库、API 等外部能力,运行本地 stdio 服务器(npx、uvx 或任意命令),或连接远程 HTTP/StreamableHTTP 服务器。

主要能力:启动时读取 ~/.hermes/config.yaml 的 mcp_servers,连接服务器并调用 list_tools() 发现工具,按 mcp_{server_name}_{tool_name} 命名注册(连字符与点替换为下划线),自动注入所有 hermes-* 平台工具集。连接以长驻 asyncio 任务运行,断线自动重连(最多 5 次,指数退避,上限 60 秒)。支持 MCP 的 sampling/createMessage,服务器可在工具执行中请求 LLM 补全,默认启用,可按服务器配置模型、令牌上限、超时、RPM、工具轮次等。

使用方式:先安装依赖 pip install mcp(或 uv pip install mcp),npx 服务器需 Node.js,uvx 服务器需 uv。在配置文件的 mcp_servers 下添加条目:stdio 用 command 与 args,HTTP 用 url 与 headers,可选 env、timeout(默认 120 秒)、connect_timeout(默认 60 秒)。每个服务器只能有 command 或 url 之一。修改后需重启智能体,目前无热重载。

限制与安全:未安装 mcp 包时 MCP 支持静默禁用;HTTP 传输需 mcp 包含 mcp.client.streamable_http,否则该服务器报 ImportError。stdio 子进程仅继承 PATH、HOME、USER、LANG、LC_ALL、TERM、SHELL、TMPDIR 及 XDG_* 等安全变量,其他环境变量需通过 env 显式传入;错误信息中的凭据样式会被自动脱敏。对不可信服务器可设 sampling: { enabled: false }。工具结果以 JSON 返回 {"result": ...} 或 {"error": ...}。原生客户端与 mcporter 相互独立,可同时使用。