Repolode
modelcontextprotocol

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. 1

    使用 npx 运行网页界面(无需安装)

    npx @modelcontextprotocol/inspector
  2. 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 数据每日更新。

相关项目