MCP开发调试神器：MCP Inspector 安装与使用全指南MCP Inspector 是专为 MCP（Model

1. MCP Inspector 安装指南

1.1 前置条件

安装 Node.js 18+（自带 npx 工具）
确保 Python MCP Server 已启动（如 simple-mcp-server 或 fastmcp）

1.2 一键安装与启动
通过 npx 直接运行（无需全局安装）：

npx @modelcontextprotocol/inspector

启动后默认访问 http://localhost:5173 进入调试界面。

1.3 自定义端口（可选）
若端口冲突，可指定客户端和代理服务器端口：

CLIENT_PORT=8080 SERVER_PORT=3000 npx @modelcontextprotocol/inspector

2. 连接 MCP Server 的两种方式

2.1 STDIO 模式（本地进程）
适用于本地开发调试，直接绑定 Python 进程：

npx @modelcontextprotocol/inspector python server.py

特点：零延迟，适合文件操作等本地工具。

环境变量传递：

npx @modelcontextprotocol/inspector -e API_KEY=12345 python server.py

2.2 SSE 模式（远程 HTTP）
适用于生产环境，需配置 FastAPI/Flask 等 Web 框架：

npx @modelcontextprotocol/inspector --url http://localhost:8000/mcp

特点：支持跨网络调用，需处理 CORS 和认证。

3. Inspector 核心功能详解

3.1 服务器连接面板

实时显示协议版本、服务器名称和状态。
支持手动触发 Reconnect 和 Disconnect。

3.2 工具测试（Tools Tab）

列出工具：展示所有注册的 @mcp.tool() 函数（如 get_weather）。

调用测试：输入参数后点击 Run，实时查看 JSON 返回结果。

{
  "method": "tools/call",
  "params": {"name": "fetch", "arguments": {"url": "https://example.com"}}
}

3.3 资源订阅（Resources Tab）

可订阅数据库、日志文件等动态资源，数据变更时自动推送。

3.4 通知面板（Notifications）

显示服务器日志和错误信息（如参数校验失败）。

4. 高级调试技巧

4.1 使用 Chrome 开发者工具分析协议

SSE 通信：在 Network 标签页过滤 EventStream，查看 Server 推送的数据流。
HTTP 请求：检查 POST /message 的请求体，验证 JSON-RPC 格式是否符合规范。

4.2 边界条件测试

无效输入：故意传递错误参数，检查错误处理逻辑。
并发调用：同时触发多个工具，观察服务器负载和响应顺序。

4.3 与客户端集成测试

在 Cursor/Claude 等支持 MCP 的客户端中配置 mcp.json，验证端到端调用链。

5. 实战案例：调试天气查询工具

步骤 1：启动天气 MCP Server

# weather.py
from fastmcp import FastMCP
mcp = FastMCP("weather")

@mcp.tool()
async def get_forecast(lat: float, lon: float) -> str:
    """获取天气预报 | lat: 纬度 | lon: 经度"""
    return f"晴, 25℃"
mcp.run()

步骤 2：连接 Inspector

npx @modelcontextprotocol/inspector python weather.py

步骤 3：测试工具

在 Tools 标签页选择 get_forecast。
输入 {"lat": 39.9, "lon": 116.4}，点击 Run。
查看返回结果和 Notifications 中的日志。

常见问题解答

Q：Inspector 无法连接 Server？
- 检查 Server 是否启动，STDIO 模式需确保命令路径正确。
Q：SSE 模式无响应？
- 确认 Server 端已启用 CORS，且路由配置正确（如 /mcp）。

结语

MCP Inspector 将复杂的协议调试转化为可视化操作，大幅提升开发效率。下一步可结合 Simple-MCP-Server-with-Python 实践更多工具开发，或探索 MCP 官方生态中的高级功能。