SuperAPI AI 工具集

mcp-server-management

部署与运维

查看项目

更新于 10-15 19:52

技能介绍

用途:在 Higress AI Gateway 上将 REST API 暴露为 MCP 工具,或代理已有的 MCP 服务器(SSE/StreamableHTTP)。适用于管理员配置 MCP 工具服务器(如 GitHub、天气 API)、轮换凭据、授予或撤销 Worker 对 MCP 工具的访问,以及添加自定义集成。

主要能力与用法:使用 setup-mcp-server.sh 从 YAML 模板创建或更新服务器,使用 setup-mcp-proxy.sh 代理已有 MCP 服务器;内置模板位于 references/mcp-*.yaml。执行前按场景阅读对应文档:创建/更新服务器或轮换凭据读 references/create-update-server.md;生成自定义 API 集成的 YAML 读 references/custom-yaml-guide.md;列出、检查、删除服务器或手动管理消费者访问读 references/api-commands.md;代理已有 MCP 服务器读 references/setup-mcp-proxy.md;需要 GitHub MCP 工具定义读 references/mcp-github.yaml。不要一次加载全部文档。

限制与注意事项:云模式(HICLAW_RUNTIME=aliyun)不支持基于脚本的 MCP 管理,应改用阿里云 AI Gateway 控制台。服务器创建或更新后认证插件约需 10 秒激活,需等待并用 mcporter 验证后再通知 Worker。通知前必须端到端验证,至少通过 mcporter 调用一个工具确认连通性,不要推送不可用的工具。不要在聊天消息中回显凭据,凭据仅存于 Higress 配置,Worker 通过网关代理访问。消费者授权是替换操作,手动调用 API 时需包含所有消费者(manager 及全部 worker),而非仅新增者。所有 YAML 配置必须使用 accessToken: "" 作为凭据键,由安装脚本替换真实值。只通知角色或任务需要该工具的相关 Worker,不要广播。MCP 服务器 SSE 端点始终返回 200,认证在 POST /mcp/<name>/message 上检查,而非 SSE 连接时。mcp-proxy 仅支持 http 和 sse 传输,stdio 服务器无法通过网关代理。