SuperAPI AI 工具集

MCP Integration

智能体与模型

查看项目

更新于 10-15 18:37

技能介绍

用途:为 Claude Code 插件接入外部服务与 API,把数据库、API、文件系统等能力以结构化工具形式暴露给 Claude Code。主要能力:可从单一服务提供 10+ 相关工具,处理 OAuth 与复杂认证,并将 MCP 服务器打包进插件实现自动配置。

配置方式:一是在插件根目录创建 .mcp.json(推荐,关注点分离、便于维护);二是在 plugin.json 中内联 mcpServers 字段(适合单服务器简单插件)。

服务器类型:stdio 以子进程运行本地服务器,适合本地工具与自定义服务器,通过 stdin/stdout 通信,Claude Code 退出时终止;SSE 连接支持 OAuth 的托管服务器,适合云服务;HTTP 连接 REST 式服务器,使用令牌认证;WebSocket 用于实时双向通信。

环境变量扩展:支持 ${CLAUDE_PLUGIN_ROOT}(插件目录,建议始终用于可移植路径)和用户环境变量替换,需在插件 README 中记录所有必需变量。

工具命名:格式为 mcp__plugin_<插件名>_<服务器名>__<工具名>。在命令 frontmatter 中可用 allowed-tools 预允许指定 MCP 工具,建议只预允许具体工具而非通配符。

生命周期:插件启用时服务器启动,首次使用工具前建立连接,配置变更需重启;用 /mcp 命令查看服务器与工具。

安全实践:使用 HTTPS/WSS;令牌用环境变量、不硬编码或提交到 git;仅预允许必要工具。

测试与排错:本地安装插件后运行 /mcp 验证,claude --debug 查看连接、工具发现与认证日志。

限制与缺失:资料未提供具体收费、价格、平台支持范围与效果数据。