MCP Inspector 实用指南Python MCP 服务器连接与工具调用测试一步到位【免费下载链接】inspectorDeterministic testing tools for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector做 Python MCP 调试最怕连接一直转圈、工具报错却看不到任何报文。MCP Inspector 是 MCP 官方出品的可视化调试客户端一条 npx 命令就能把 MCP 服务器连接、工具调用测试与请求监控收进同一块界面。能力速览一句话概括它是 MCP 协议的官方调试客户端一个包内含 web、CLI、TUI 和实验性 mcpdo 四种形态。用得最多的是 web 形态Node 后端 React SPA支持 stdio、SSE、Streamable HTTP 三种 MCP 服务器连接方式内置 Bearer Token 与 OAuth 认证可以可视化调用工具、浏览资源与提示词、查看日志和完整请求历史Network 标签页里还有原始 JSON-RPC 报文。从安装到首次连接本地跑起来只需要一条命令要求 Node ≥ 22.19npx modelcontextprotocol/inspector不想装 Node 环境就用 Docker 镜像docker run --rm -p 127.0.0.1:6274:6274 ghcr.io/modelcontextprotocol/inspector启动后打开http://localhost:6274。左侧连接面板要配三样东西传输类型stdio / SSE / HTTP、启动命令stdio 下如python server.py或远程 URL以及下方的启动参数和-e环境变量项。首次启动时目录会自动种入三个示例服务器——两个本地 stdio一个官方远程 example server直接点 Connect 就能先跑通整个流程。一次完整的工具调用测试连接后进入 Tools 标签页。左栏列出服务器暴露的全部工具及其注解read-only、destructive 等点选一个中栏按 inputSchema 渲染出参数表单必填字段带红星。填好参数点 Execute Tool右栏 Results 返回 JSON 结果。结果怎么算正常看三件事其一content 数组结构是否完整其二结果里有没有isError: true——服务端工具内部抛的异常未必会中断调用其三到 Network 标签页对照请求体确认发出去的参数按 inputSchema 转成了预期类型表单输入都是字符串由客户端负责转换。另外注意左栏工具行的红/黄警示图标出现即表示 schema 本身不被真实客户端接受经典案例是 Go 服务器对 interface{} 字段发出裸true展开 Schema portability 就能看到具体路径与修复建议。让调试更高效环境变量、超时与日志高频用法先说环境变量。密钥不写死在启动脚本里用-e传给 stdio 服务器npx modelcontextprotocol/inspector -e API_KEYyour-key python server.py-e可重复书写这些值默认存入操作系统钥匙串不落配置文件明文。其余几个常用项超时连接超时connectionTimeout默认 30 秒长任务用 Run as tasktaskTtl 默认 60 秒与单次请求超时解耦慢任务不会拖垮整条连接。日志modern 协议连接可打每请求日志级别默认 debug想验证服务端静默行为就调成 offTUI 用LOG_LEVEL进程崩溃时开MCP_DEBUG拿到完整堆栈。网络远程 HTTP/SSE 服务器用--header附加固定请求头内网代理环境遵循HTTPS_PROXY/NO_PROXY。完整变量清单见环境变量文档服务器配置文件格式见配置文档。踩坑排查连接一直转圈状态卡在 connecting 不进 connected。最常见是 stdio 启动命令本身没跑起来——解释器路径不对、依赖没装先手动在终端执行一遍其次是传输类型与服务端不匹配把 SSE 端点当成 http 连。确认握手已到达服务端后到 Network 标签页看 initialize 响应是否完整。工具执行返回 Invalid input多半是参数类型与 inputSchema 声明不一致字符串2对 number 字段或 schema 本身含真实客户端不接受的构造。切到 Edit as JSON 直接核对将发送的载荷若多个工具都报同类错误问题在服务端 schema 侧按 Schema portability 给出的路径改服务器而不是在客户端打转。OAuth 授权页拒绝 redirect_uri预配置的 clientId 没注册 Inspector 的回调地址或端口变了注册没跟上。到 Server Settings → OAuth Settings 复制当前 redirect URI默认http://localhost:6274/oauth/callback到授权服务器注册动态注册的客户端可跳过这步。跑完上面三步一个 Python MCP 服务器的连接 → 调用 → 验证闭环就齐了再配合 CLI 的--format json还能把这套流程搬进 CI 变成断言。现在就启动npx modelcontextprotocol/inspector连上自带示例服务器把第一个工具跑起来吧。【免费下载链接】inspectorDeterministic testing tools for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
MCP Inspector 实用指南Python MCP 服务器连接与工具调用测试一步到位【免费下载链接】inspectorDeterministic testing tools for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector做 Python MCP 调试最怕连接一直转圈、工具报错却看不到任何报文。MCP Inspector 是 MCP 官方出品的可视化调试客户端一条 npx 命令就能把 MCP 服务器连接、工具调用测试与请求监控收进同一块界面。能力速览一句话概括它是 MCP 协议的官方调试客户端一个包内含 web、CLI、TUI 和实验性 mcpdo 四种形态。用得最多的是 web 形态Node 后端 React SPA支持 stdio、SSE、Streamable HTTP 三种 MCP 服务器连接方式内置 Bearer Token 与 OAuth 认证可以可视化调用工具、浏览资源与提示词、查看日志和完整请求历史Network 标签页里还有原始 JSON-RPC 报文。从安装到首次连接本地跑起来只需要一条命令要求 Node ≥ 22.19npx modelcontextprotocol/inspector不想装 Node 环境就用 Docker 镜像docker run --rm -p 127.0.0.1:6274:6274 ghcr.io/modelcontextprotocol/inspector启动后打开http://localhost:6274。左侧连接面板要配三样东西传输类型stdio / SSE / HTTP、启动命令stdio 下如python server.py或远程 URL以及下方的启动参数和-e环境变量项。首次启动时目录会自动种入三个示例服务器——两个本地 stdio一个官方远程 example server直接点 Connect 就能先跑通整个流程。一次完整的工具调用测试连接后进入 Tools 标签页。左栏列出服务器暴露的全部工具及其注解read-only、destructive 等点选一个中栏按 inputSchema 渲染出参数表单必填字段带红星。填好参数点 Execute Tool右栏 Results 返回 JSON 结果。结果怎么算正常看三件事其一content 数组结构是否完整其二结果里有没有isError: true——服务端工具内部抛的异常未必会中断调用其三到 Network 标签页对照请求体确认发出去的参数按 inputSchema 转成了预期类型表单输入都是字符串由客户端负责转换。另外注意左栏工具行的红/黄警示图标出现即表示 schema 本身不被真实客户端接受经典案例是 Go 服务器对 interface{} 字段发出裸true展开 Schema portability 就能看到具体路径与修复建议。让调试更高效环境变量、超时与日志高频用法先说环境变量。密钥不写死在启动脚本里用-e传给 stdio 服务器npx modelcontextprotocol/inspector -e API_KEYyour-key python server.py-e可重复书写这些值默认存入操作系统钥匙串不落配置文件明文。其余几个常用项超时连接超时connectionTimeout默认 30 秒长任务用 Run as tasktaskTtl 默认 60 秒与单次请求超时解耦慢任务不会拖垮整条连接。日志modern 协议连接可打每请求日志级别默认 debug想验证服务端静默行为就调成 offTUI 用LOG_LEVEL进程崩溃时开MCP_DEBUG拿到完整堆栈。网络远程 HTTP/SSE 服务器用--header附加固定请求头内网代理环境遵循HTTPS_PROXY/NO_PROXY。完整变量清单见环境变量文档服务器配置文件格式见配置文档。踩坑排查连接一直转圈状态卡在 connecting 不进 connected。最常见是 stdio 启动命令本身没跑起来——解释器路径不对、依赖没装先手动在终端执行一遍其次是传输类型与服务端不匹配把 SSE 端点当成 http 连。确认握手已到达服务端后到 Network 标签页看 initialize 响应是否完整。工具执行返回 Invalid input多半是参数类型与 inputSchema 声明不一致字符串2对 number 字段或 schema 本身含真实客户端不接受的构造。切到 Edit as JSON 直接核对将发送的载荷若多个工具都报同类错误问题在服务端 schema 侧按 Schema portability 给出的路径改服务器而不是在客户端打转。OAuth 授权页拒绝 redirect_uri预配置的 clientId 没注册 Inspector 的回调地址或端口变了注册没跟上。到 Server Settings → OAuth Settings 复制当前 redirect URI默认http://localhost:6274/oauth/callback到授权服务器注册动态注册的客户端可跳过这步。跑完上面三步一个 Python MCP 服务器的连接 → 调用 → 验证闭环就齐了再配合 CLI 的--format json还能把这套流程搬进 CI 变成断言。现在就启动npx modelcontextprotocol/inspector连上自带示例服务器把第一个工具跑起来吧。【免费下载链接】inspectorDeterministic testing tools for MCP servers项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
