用途:在项目中检查与配置 MCP(Model Context Protocol)服务器,便于项目集成。理念是服务器按项目管理(写入 .mcp.json),而非用户级(~/.claude/settings.json),以保持上下文清晰、依赖明确。
主要能力:检测 .mcp.json 是否存在并列出已配置服务器;检查各服务器命令类型(npx、bunx、uvx、go run)与所需环境变量,标记缺失项;安装指定或核心服务器(context7、sequential-thinking);根据项目线索(如 playwright.config.*、大型 TS/Python/Rust 代码库)推荐服务器;报告状态并给出后续步骤(重启 Claude Code、设置环境变量);如存在 .project-standards.yaml 则更新其 MCP 部分。
用法:命令为 /configure:mcp。参数:--check-only 仅报告不安装;--fix 无需确认直接安装;--core 安装全部核心服务器;--server <name> 安装指定服务器(可重复)。无参数时进入交互模式(检测→报告→询问是否安装)。配置完成后可在 Claude Code 中用 /mcp、/mcp enable <server>、/mcp disable <server> 管理服务器,启停仅限当前会话,永久变更需编辑 .mcp.json。
适用场景:为项目搭建 MCP 服务器、检查服务器状态与配置校验、添加 context7、playwright、sequential-thinking 等特定服务器、保证团队可共享的 MCP 配置。
限制与注意事项:用户级设置应直接编辑 ~/.claude/settings.json;仅查看 .mcp.json 内容可用 Read 工具;非 MCP 用途的包安装使用包管理器;调试特定服务器运行时问题需查看服务器日志并重启 Claude Code。错误处理:.mcp.json 无效可备份并替换为有效模板;服务器已安装则跳过并提示;缺少环境变量会警告但继续;未知服务器会报错并列出可用服务器名。具体服务器配置、环境变量参考与报告模板见 REFERENCE.md,本次资料未提供其内容。