如何快速掌握MCP服务器调试：从零开始的完整指南

如何快速掌握MCP服务器调试从零开始的完整指南【免费下载链接】inspectorVisual testing tool for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspectorMCP Inspector是一款强大的MCP服务器测试与调试工具它提供了直观的用户界面和丰富的功能帮助开发者轻松测试和调试MCP服务器。无论你是MCP服务器开发的新手还是有经验的开发者本指南都将帮助你快速掌握MCP服务器调试的核心技能。MCP Inspector主界面展示了工具面板、历史记录和服务器通知等核心功能区域快速开始安装与启动MCP InspectorMCP Inspector的安装过程非常简单只需确保你的系统已安装Node.js版本^22.7.5然后通过以下命令即可快速启动npx modelcontextprotocol/inspector执行上述命令后服务器将自动启动你可以在浏览器中访问http://localhost:6274来使用MCP Inspector的Web界面。如果你更喜欢使用Docker容器运行也可以使用以下命令docker run --rm \ -p 127.0.0.1:6274:6274 \ -p 127.0.0.1:6277:6277 \ -e HOST0.0.0.0 \ -e MCP_AUTO_OPEN_ENABLEDfalse \ ghcr.io/modelcontextprotocol/inspector:latestMCP Inspector核心功能介绍MCP Inspector主要由两个核心组件构成MCP Inspector客户端MCPI一个基于React的Web界面提供交互式的MCP服务器测试和调试功能MCP代理MCPP一个Node.js服务器作为协议桥接器通过多种传输方式stdio、SSE、streamable-http连接Web界面和MCP服务器这两个组件协同工作使开发者能够通过浏览器轻松与各种传输协议的MCP服务器进行交互。连接MCP服务器的三种方式1. 直接运行MCP服务器如果你已经有一个MCP服务器的实现无需克隆MCP Inspector仓库可以直接使用npx命令运行npx modelcontextprotocol/inspector node build/index.js你还可以传递参数和环境变量给MCP服务器# 仅传递参数 npx modelcontextprotocol/inspector node build/index.js arg1 arg2 # 仅传递环境变量 npx modelcontextprotocol/inspector -e keyvalue -e key2$VALUE2 node build/index.js # 同时传递环境变量和参数 npx modelcontextprotocol/inspector -e keyvalue -e key2$VALUE2 node build/index.js arg1 arg22. 使用配置文件MCP Inspector支持使用配置文件来存储不同MCP服务器的设置这对于使用多个服务器或复杂配置时非常有用npx modelcontextprotocol/inspector --config path/to/config.json --server everything示例配置文件{ mcpServers: { everything: { command: npx, args: [modelcontextprotocol/server-everything], env: { hello: Hello MCP! } }, my-server: { command: node, args: [build/index.js, arg1, arg2], env: { key: value, key2: value2 } } } }3. 连接远程MCP服务器MCP Inspector不仅可以连接本地服务器还可以连接远程MCP服务器# 连接SSE传输的远程服务器 npx modelcontextprotocol/inspector --cli https://my-mcp-server.example.com # 连接Streamable HTTP传输的远程服务器 npx modelcontextprotocol/inspector --cli https://my-mcp-server.example.com --transport http探索MCP Inspector的强大功能服务器配置导出MCP Inspector提供了方便的按钮来导出服务器启动配置用于Cursor、Claude Code或Inspector的CLI等客户端。这些按钮在你配置服务器设置后会出现在Inspector UI中Server Entry将单个服务器配置项复制到剪贴板可以添加到mcp.json文件中的mcpServers对象Servers File将完整的MCP配置文件结构复制到剪贴板可以直接保存为mcp.json认证支持MCP Inspector支持SSE连接的Bearer令牌认证。在连接MCP服务器时在UI中输入令牌它将在Authorization头中发送。你可以使用侧边栏中的输入字段覆盖头名称。安全注意事项MCP Inspector包含一个代理服务器可以运行并与本地MCP进程通信。默认情况下MCP Inspector代理服务器需要身份验证 Session token: 3a1c267fad21f7150b7d624c160b7f09b0b8c4f623c7107bbf13378f051538d4 Open inspector with token pre-filled: http://localhost:6274/?MCP_PROXY_AUTH_TOKEN3a1c267fad21f7150b7d624c160b7f09b0b8c4f623c7107bbf13378f051538d4⚠️警告禁用身份验证非常危险除非你真正了解风险否则不要使用DANGEROUSLY_OMIT_AUTHtrue环境变量。CLI模式命令行交互CLI模式允许从命令行与MCP服务器进行程序化交互非常适合脚本编写、自动化和与编码助手集成npx modelcontextprotocol/inspector --cli node build/index.js一些常用的CLI命令示例# 列出可用工具 npx modelcontextprotocol/inspector --cli node build/index.js --method tools/list # 调用特定工具 npx modelcontextprotocol/inspector --cli node build/index.js --method tools/call --tool-name mytool --tool-arg keyvalue # 列出可用资源 npx modelcontextprotocol/inspector --cli node build/index.js --method resources/list # 列出可用提示 npx modelcontextprotocol/inspector --cli node build/index.js --method prompts/listUI模式与CLI模式如何选择使用场景UI模式CLI模式服务器开发开发过程中的交互式测试和调试的可视化界面用于快速测试和持续集成的脚本命令与AI编码助手如Cursor创建反馈循环实现快速开发资源探索具有分层导航和JSON可视化的交互式浏览器用于自动化和脚本的程序化列表和读取工具测试基于表单的参数输入和实时响应可视化带JSON输出的命令行工具执行用于脚本编写提示工程具有流响应和视觉比较的交互式采样带机器可读输出的提示批处理调试请求历史、可视化错误和实时通知用于日志分析和与其他工具集成的直接JSON输出自动化N/A非常适合CI/CD管道、批处理和与编码助手集成学习MCP丰富的视觉界面帮助新用户了解服务器功能用于特定端点集中学习的简化命令从源码运行MCP Inspector如果你想为MCP Inspector贡献代码或进行自定义修改可以从源码运行开发模式npm run dev # 如需与typescript-sdk包共同开发假设克隆在../typescript-sdk中否则设置MCP_SDK npm run dev:sdk cd sdk npm run examples:simple-server:w生产模式npm run build npm start总结MCP Inspector是MCP服务器开发的必备工具它提供了直观的UI界面和强大的CLI功能使MCP服务器的测试和调试变得简单而高效。通过本指南你已经了解了MCP Inspector的安装、配置和使用方法现在可以开始使用这个强大的工具来加速你的MCP服务器开发流程了无论是通过UI界面进行交互式测试还是使用CLI模式进行自动化脚本编写MCP Inspector都能满足你的需求帮助你构建更稳定、更可靠的MCP服务器。要了解更多关于MCP Inspector的详细信息可以查看项目中的README.md文件或探索项目的源代码结构如cli/src/目录下的CLI实现和client/src/目录下的UI组件。【免费下载链接】inspectorVisual testing tool for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考