SuperAPI AI 工具集

mcp-integration

智能体与模型

查看项目

更新于 10-15 16:50

技能介绍

用途:在 Claude Code 插件中集成 MCP,使插件可连接数据库、API、文件系统等外部服务,并将外部能力作为工具提供给 Claude Code 使用。单个服务可提供 10 个以上相关工具,支持 OAuth 与复杂鉴权流程,也可随插件打包 MCP 服务器实现自动配置。

配置方式:一是在插件根目录创建 .mcp.json(推荐,职责清晰、便于维护、适合多服务器);二是在 plugin.json 中通过 mcpServers 字段内联(适合简单单服务器插件)。

服务器类型:stdio 以子进程方式运行本地服务器,适合本地工具与自定义服务器,进程由 Claude Code 启动管理并通过 stdin/stdout 通信;SSE 连接托管服务器并支持 OAuth,适合云服务,无需本地安装;HTTP 连接 RESTful 服务器,使用令牌或请求头鉴权;ws 用于实时双向通信。配置支持环境变量替换,如 ${CLAUDE_PLUGIN_ROOT} 用于可移植路径,以及用户 shell 中的环境变量。

工具命名与权限:工具会带前缀,格式为 mcp__plugin_<plugin-name>_<server-name>__<tool-name>。可在命令 frontmatter 的 allowed-tools 中预先允许指定的 MCP 工具,建议精确指定而非使用通配符。可用 /mcp 命令查看所有服务器及工具。配置变更后需重启。

安全与调试:应使用 HTTPS/WSS,令牌用环境变量而非硬编码,不提交凭据到 git,并在 README 记录所需环境变量。可用 claude --debug 查看连接、工具发现、鉴权与调用错误日志。

限制:资料未提供具体收费、价格或效果数据;其余细节以官方文档为准。