用途:MCP 是给 Claude Code 添加自定义工具的协议,适用于提供项目专属工具、连接外部服务以及实现自动化任务。
主要能力:可通过 @modelcontextprotocol/sdk 创建服务器,定义 tools/list 与 tools/call 处理器,向 Claude Code 暴露自定义工具。资料给出的示例包括测试运行器(run_tests)和数据库查询(query_database)。
使用方式:服务器代码通常放在 scripts/mcp/ 下,例如 scripts/mcp/my-tool.js,使用 StdioServerTransport 启动。配置分两级:项目级写在 .mcp.json 的 mcpServers 中,用户级写在 ~/.claude/settings.json。可用 disabledMcpServers 停用不常用的服务器以节省上下文。调试可直接运行 node scripts/mcp/my-tool.js,或用 DEBUG=mcp* 查看日志,也可在 Claude Code 中用 /mcp 命令查看连接状态。
适用场景:需要为项目提供专属工具、集成外部服务或封装自动化任务时使用。
限制与建议:错误处理应始终使用 try-catch;避免长时间处理,建议 30 秒以内;description 要清晰以便模型选择工具;inputSchema 必须明确参数类型;每个项目的 MCP 数量建议控制在 10 个以下。安装命令、依赖版本及收费信息暂未提供。