开源的 MCP 服务器测试与评估平台,用于检查、对话和调试 MCP 服务器与应用。
modelcontextprotocol/inspector
用于测试和调试 MCP 服务器的开发者工具,提供网页、命令行和终端界面三种使用方式。
- Star
- 11,119
- Fork
- 1,545
- 未关闭 Issue
- 26
- 最近提交
- 17小时前
这是什么?
MCP Inspector 用于连接 Model Context Protocol(MCP)服务器,查看其暴露的工具、资源和提示词,并直接调用它们以检查行为。项目以单一包 @modelcontextprotocol/inspector 发布,通过 mcp-inspector 命令提供网页界面(默认)、可脚本化的 CLI 和交互式终端界面三种方式。
网页端基于 Vite、React 和 Mantine 构建,配有 Node 后端。CLI 面向自动化和 CI 场景,可以完成连接、列出、调用和断言等冒烟测试流程,并支持 JSON 输出,便于配合 jq 使用。TUI 基于 Ink 构建,提供交互式终端操作。
安装包中还包含实验性的 mcpdo 命令,可以连接一次命名服务器,随后通过本地守护进程执行多条命令。OAuth 令牌和 stdio 环境变量等敏感信息在系统可用时保存到操作系统钥匙串,否则回退到文件存储。
核心功能
- 01网页界面,用于浏览和调用 MCP 服务器的工具、资源和提示词
- 02可脚本化的 CLI,支持 JSON 输出,适合自动化和 CI 冒烟测试
- 03基于 Ink 构建的交互式终端界面
- 04系统可用时将 OAuth 令牌和密钥保存到操作系统钥匙串
- 05实验性的 mcpdo 命令,可在多条命令间复用同一连接
适用场景
- 开发自定义 MCP 服务器时,在接入 AI 客户端前进行调试
- 在 CI 中对 MCP 服务器执行连接、列出、调用和断言检查
- 交互式或非交互式地测试需要 OAuth 认证的 MCP 服务器
- 快速查看陌生 MCP 服务器提供的工具及其输入参数
快速上手
- 1
使用 npx 运行网页界面(无需安装)
npx @modelcontextprotocol/inspector - 2
或者改为运行命令行客户端
npx @modelcontextprotocol/inspector --cli
使用前须知
- 许可证显示为 NOASSERTION,且 README 描述了 MIT 与 Apache-2.0 混合授权的过渡状态,复用前请查看 LICENSE。
- 在没有操作系统钥匙串的机器上,OAuth 令牌等机密会以未加密形式保存到 ~/.mcp-inspector/secrets.json,除非你提供密钥。
- 开发需要 Node 22.19.0 或更高版本。
标签
常见问题
- inspector 是什么?
- 用于测试和调试 MCP 服务器的开发者工具,提供网页、命令行和终端界面三种使用方式。 MCP Inspector 用于连接 Model Context Protocol(MCP)服务器,查看其暴露的工具、资源和提示词,并直接调用它们以检查行为。项目以单一包 @modelcontextprotocol/inspector 发布,通过 mcp-inspector 命令提供网页界面(默认)、可脚本化的 CLI 和交互式终端界面三种方式。
- inspector 可以免费使用吗?用的什么许可证?
- inspector 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- inspector 还在维护吗?
- 活跃维护中。inspector 最近一次提交是在 2026年10月21日。
- inspector 适合用来做什么?
- 开发自定义 MCP 服务器时,在接入 AI 客户端前进行调试 在 CI 中对 MCP 服务器执行连接、列出、调用和断言检查 交互式或非交互式地测试需要 OAuth 认证的 MCP 服务器 快速查看陌生 MCP 服务器提供的工具及其输入参数
- inspector 怎么安装和运行?
- 使用 npx 运行网页界面(无需安装): npx @modelcontextprotocol/inspector 或者改为运行命令行客户端: npx @modelcontextprotocol/inspector --cli
- 在哪里获取 inspector?
- 源代码和安装说明在 GitHub 上:https://github.com/modelcontextprotocol/inspector
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
Python 调试工具,用 ic() 替代 print(),同时输出变量名、表达式及其值,并支持格式化和语法高亮。
用于测试、调试和自动化 MCP 服务器的终端 UI 与命令行工具,支持 stdio、SSE 和 HTTP。
一个命令行工具,让 AI 智能体能够操作 REPL、调试器和 TUI 等需要键盘交互的终端程序。
面向 Model Context Protocol(MCP)服务端开发的开发者工具、SDK、库和测试工具精选列表。
用于编译、部署、测试和调试以太坊智能合约与去中心化应用的开发环境。