mcp-installer

用途：把 MCP 服务器配置安装到多个客户端与操作系统上，采用命令行优先流程，并保留安全的手动回退方式。\n\n主要能力与流程：\n1) 收集输入：确定目标客户端 ID 与操作系统，参考 references/clients.md 获取支持列表与已知路径；收集 MCP 服务器定义（名称到配置对象），决定是否覆盖已有条目。若配置含密钥字段（如 key、token、apiKey、accessToken、secret、password、Authorization，或 _KEY、_TOKEN 等环境变量），应暂停安装，要求用户先提供凭证，或确认安装占位符稍后填写。\n2) CLI 优先：先运行 npx @smithery/cli --help 与 npx @smithery/cli install --help 确认语法，再用 CLI 按客户端 ID 安装；若 CLI 不支持或失败，转手动编辑。\n3) 手动安装（JSON 回退）：定位配置文件路径（可用 mcp.json、mcp_config.json、claude_desktop_config.json、cline_mcp_settings.json 等），读取现有 JSON 并确保存在顶层 mcpServers 对象；合并服务器，新增名称、在 override 为真时替换既有项，保留其它键；以 2 空格缩进写入 JSON。配置结构示例为 command、args、env 字段。\n4) 验证与排错：重启客户端确认服务器出现；macOS 写入失败时申请完全磁盘访问权限，并先关闭客户端；纯 CLI 客户端（如 claude-code）用其 CLI 帮助查找 MCP 安装命令；Trae/Trae-CN 因权限等失败时生成 deep link 作为回退。\n5) Trae deep link 回退：无法写盘时生成 schema 链接供用户在 Trae 打开，格式为 trae://trae.ai-ide/mcp-import?type=${TYPE}&name=${NAME}&config=${BASE64_ENCODED_CONFIG}（trae-cn 同理），其中 TYPE 是传输类型，NAME 为服务器名，config 为对应服务器 JSON 配置的 base64 编码（无空白、UTF-8 字节）。\n\n限制：具体支持的客户端清单与路径以 references/clients.md 为准；涉及密钥时需用户自行提供，未提供则不应继续安装；部分客户端可能仅支持 CLI 或需特定权限。