SuperAPI AI 工具集

mcp-installer

部署与运维

查看项目

更新于 10-16 00:00

技能介绍

用途:在多个客户端与操作系统上安装 MCP 服务器配置,采用 CLI 优先的工作流,并提供安全的手动回退方式。

主要能力:识别目标客户端 ID 与操作系统;收集 MCP 服务器定义(名称到配置对象)并决定是否覆盖已有条目;优先使用 @smithery/cli 完成安装;CLI 不支持或失败时改为手动编辑 JSON 配置;支持 Trae/Trae-CN 的深链接回退。

使用方式:先确认客户端 ID 与系统,参考 references/clients.md 获取支持列表与已知路径。若配置含密钥(如 key、token、apiKey、accessToken、secret、password、Authorization 或 _KEY、_TOKEN 等环境变量),暂停安装并要求用户先提供凭据。优先运行 npx @smithery/cli --help 与 npx @smithery/cli install --help 确认语法,再执行安装。手动安装时定位配置文件(如 mcp.json、mcp_config.json、claude_desktop_config.json、cline_mcp_settings.json),读取现有 JSON,确保存在顶层 mcpServers 对象,合并服务器条目(override 为 true 时替换),保留其他键,以 2 空格缩进写入。完成后重启客户端确认服务器出现。

适用场景:需要跨多个客户端批量配置 MCP 服务器的用户,尤其是同时使用桌面与 CLI 客户端的场景。

限制:macOS 写入失败时需授予完全磁盘访问权限并关闭客户端应用;仅 CLI 客户端需用其自身 CLI 帮助查找 MCP 安装命令;Trae/Trae-CN 因权限等错误写入失败时,改用深链接回退(trae://trae.ai-ide/mcp-import 或 trae-cn://trae.ai-ide/mcp-import,参数含 type、name 与 base64 编码的 config)。具体收费、价格与平台支持范围暂未提供。