用途
MCP 工具安装助手用于帮助用户从 GitHub 搜索并安装 MCP(Model Context Protocol)服务器配置。当用户需要安装 MCP 工具时触发此技能。
主要能力
- 搜索阶段:询问用户需要什么类型的 MCP 工具;使用 GitHub 搜索功能查找相关项目;搜索关键词格式为「mcp server + 用户关键词」或「mcp- + 关键词」;优先寻找官方 ModelContextProtocol 组织下的项目;查找项目的 README 或文档,确认正确的 npx 安装命令。
- 配置提取:从项目文档中提取标准的 npx 配置格式。标准格式为 mcpServers 下包含工具名、command 为 npx、args 为 ["-y", "包名@latest"];带环境变量的格式在此基础上增加 env 字段,内含 API_KEY 等占位符。
- 配置安装:读取用户现有的 ~/.claude.json 配置文件;检查是否已存在同名 MCP 服务器配置;将新配置添加到 mcpServers 字段中;保持 JSON 格式正确,确保不破坏现有配置;如果配置文件不存在,创建新文件。
- 密钥处理:如果 MCP 工具需要 API 密钥,明确告知用户;在配置中预留环境变量字段;用 YOUR_API_KEY_HERE 等占位符标注;提供获取密钥的指导链接或说明。
- 完成确认:配置完成后输出工具名称、项目地址、配置位置,以及需要配置的密钥(如有)和获取说明,并提示用户重启 Claude Code 以加载新配置。
使用方式
用户提出安装 MCP 工具的需求后,助手按搜索、配置提取、配置安装、密钥处理、完成确认的流程执行。可用工具包括:GitHub 搜索(mcp__github__search_repositories)、GitHub 获取文件内容(mcp__github__get_file_contents)、读取配置文件(Read 工具)、写入配置文件(Write 工具)。
适用场景
需要从 GitHub 查找并安装 MCP 服务器工具,并将其配置写入 Claude 配置文件的场景。
限制与注意事项
- Windows 用户配置文件位于 %USERPROFILE%.claude.json;macOS/Linux 用户配置文件位于 ~/.claude.json。
- 处理 JSON 解析错误时,给出清晰的错误提示。
- 如果 GitHub 搜索无结果,建议调整搜索关键词。
- 对于复杂的配置(非简单 npx),建议用户手动配置并提供指导。
关于收费、价格、平台支持范围等信息,资料暂未提供。