mcp-explorer 官网首屏

mcp-explorer：MCP 服务器的命令行调试器

mcp-explorer 是 Simon Willison 发布的 CLI 工具，用于探索和调用 MCP（Model Context Protocol）服务器。它把「这个服务器暴露了哪些工具、每个工具的参数结构是什么、能不能直接调用」压缩成几条命令——MCP 服务器开发者调试接口、Agent 开发者确认工具可用性时，不需要再手写 HTTP 请求或依赖某个聊天客户端。

工具诞生于 MCP 2.0 无状态协议发布当天（2026-07-28），默认强制使用新的 stateless 协议，同时保留 --legacy 参数兼容旧版 initialize 握手流程。截至 2026-08-01，GitHub 50 Star，Apache 2.0 协议。

核心能力

一条命令列出服务器全部工具

mcp-explorer list <https://agentic-mermaid.dev/mcp>

默认输出是紧凑的签名 + 一行描述；加 -N 展开完整描述和参数元数据；加 --json 输出包含输入 schema 的完整工具定义。查看某个 MCP 服务器到底暴露了什么，这是最快的入口。

查看单个工具细节

mcp-explorer inspect <https://agentic-mermaid.dev/mcp> render_svg

显示工具的完整描述、嵌套的输入输出 schema、注解、执行元数据、图标和 _meta。调试「这个参数到底接不接受数组」这类问题，比翻服务器源码快。

直接调用工具

mcp-explorer call <https://agentic-mermaid.dev/mcp> verify '{"source":"graph TD; A-->B"}'

参数可以是 JSON 对象，也可以用可重复的 -a name value 传参，或从 stdin 读。参数会按工具的输入 schema 校验后才调用——类型错误在本地就被拦下。--json 输出结构化内容，--raw 输出完整 MCP CallToolResult。

协议健康检查

mcp-explorer doctor <https://agentic-mermaid.dev/mcp>

同时检查 stateless 和 legacy 两种协议的兼容性，返回退出码供脚本判断。对正在迁移到 MCP 2.0 的服务器运维很有用。

prompts 和 resources 子命令分别列出服务器暴露的提示词和可直接寻址的资源（含 URI、MIME 类型、大小）。

为什么值得关注

MCP 2.0 无状态化的核心变化是：旧协议要两次 HTTP 请求（initialize 拿 session id，再调工具），新协议一次请求搞定，请求头直接带 MCP-Protocol-Version 和 Mcp-Method。这大幅降低了 MCP 客户端和服务器两端的实现复杂度——Simon Willison 在一周内构建了三个客户端/服务器实现，mcp-explorer 是其中之一。

对开发者来说，mcp-explorer 解决的是「MCP 生态的调试盲区」：以前想确认一个远程 MCP 服务器是否可用、暴露了什么，得写脚本或开着聊天客户端逐步试。现在一条命令就能列出、检查、调用、验证。doctor 子命令还能告诉你在 MCP 2.0 迁移中服务器是否兼容新协议。

局限

只支持 Streamable HTTP 类型的 MCP 服务器，不覆盖 stdio 本地服务器
项目很新（2026-07-28 创建），Star 数 50，生态验证还早
无图形界面，纯 CLI——不熟悉命令行的用户有学习成本

快速开始

pip install mcp-explorer
mcp-explorer list <https://agentic-mermaid.dev/mcp>
mcp-explorer doctor <https://agentic-mermaid.dev/mcp>

mcp-explorer | MCP 服务器调试 CLI

mcp-explorer：MCP 服务器的命令行调试器

核心能力

为什么值得关注

局限

快速开始

延伸阅读