SuperAPI AI 工具集

hap-mcp-usage

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:本技能用于在 AI 工具中自动化配置明道云 HAP 的 MCP 服务器,并在配置后验证连通性。当用户提到“配置 MCP”“添加 MCP 服务器”“设置 MCP 连接”,或提供含 hap-mcp- 的配置、含 HAP-Appkey 与 HAP-Sign 的 URL 时触发。

主要能力:区分两类 HAP MCP。一是 HAP API 文档 MCP,只读,让 AI 读懂接口文档,官方固定配置为 npx -y apifox-mcp-server@latest --site-id=5442569。二是 HAP 应用执行 MCP,可操作真实数据,配置为 url 加 type: streamable。支持 Claude Code、TRAE、Cursor、GitHub Copilot、Google Antigravity、OpenCode、Windsurf、Gemini CLI、Codex 共 9 种平台。

使用方式:先识别平台,再解析服务器名称、URL 与 MCP 类型,然后按平台写入对应配置文件。Claude Code 用 claude mcp add <server-name> --url "<server-url>",验证用 claude mcp list。Cursor 写 .cursor/mcp.json 或 ~/.cursor/mcp.json;TRAE 写 .trae/mcp.json;GitHub Copilot 写 ~/.copilot/mcp-config.json;Antigravity 写 ~/.gemini/antigravity/mcp_config.json;OpenCode 写 ~/.config/opencode/opencode.json;Windsurf 写 ~/.codeium/windsurf/mcp_config.json;Gemini CLI 用 gemini mcp add 或 settings.json;Codex 写 ~/.codex/config.toml。配置后调用 get_app_info 验证连通性。

限制:Codex 的 TOML 不支持中文 key,需将中文名称转为英文 kebab-case。type: streamable 是否必需取决于平台,建议添加以提高兼容性。配置须增量更新,不得删除已有 MCP。需保护 HAP-Appkey 与 HAP-Sign,避免提交到 Git。具体收费、价格与效果资料暂未提供。