SuperAPI AI 工具集

MCP Integration

智能体与模型

查看项目

更新于 10-15 16:49

技能介绍

用途:该技能用于为 Claude Code 插件集成 Model Context Protocol(MCP),把数据库、API、文件系统等外部服务的能力以结构化工具形式暴露给 Claude Code,供命令与智能体调用。

主要能力:可连接外部服务并提供同一服务下的多个工具;支持 OAuth 与复杂认证流程;支持随插件打包 MCP 服务器实现自动配置。

配置方式:推荐在插件根目录创建 .mcp.json,把服务器放在顶层字段(如 database-tools、filesystem);也可在 plugin.json 的 mcpServers 字段内联配置,适合单服务器简单插件。

服务器类型:stdio(本地子进程,通过 stdin/stdout 通信,随 Claude Code 退出终止,适合本地工具与自建服务器)、SSE(连接托管服务器,OAuth 自动处理,适合云服务)、HTTP(REST 风格,使用请求头令牌认证)、ws(WebSocket,适合实时双向通信)。配置支持环境变量替换,路径应使用 ${CLAUDE_PLUGIN_ROOT} 保持可移植性。

工具命名与使用:工具自动加前缀,格式为 mcp__plugin_<插件名>_<服务器名>__<工具名>;可在命令 frontmatter 的 allowed-tools 中预先允许具体工具,建议避免通配符。使用 /mcp 查看已加载服务器,用 claude --debug 查看连接、工具发现与认证日志。

生命周期:插件启用时解析 MCP 配置并启动或建立连接,发现并注册工具;配置变更后需重启。

限制与安全:应使用 HTTPS/WSS,令牌走环境变量而非硬编码或提交到仓库,按最小权限预允许工具,并处理连接失败、工具调用错误与配置错误。文档未提供具体收费与价格信息。