作者 MCPJam · MCPJam/inspector
构建 MCP 服务器时你梦寐以求的调试器——JSON-RPC 追踪、跨 LLM 工具评估、OAuth 合规性检查、CI 集成。
MCPJam Inspector 是为 MCP 服务器开发的平台。提供 Web 应用、桌面应用、终端和 Docker。调试工具调用，与任何 LLM 对话测试你的服务器，跨模型运行评估测试，集成 CI 捕捉 PR 中的回归。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"inspector"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"inspector"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"inspector"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"inspector": {
"command": "npx",
"args": [
"-y",
"inspector"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "inspector",
"command": "npx",
"args": [
"-y",
"inspector"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"inspector": {
"command": {
"path": "npx",
"args": [
"-y",
"inspector"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add inspector -- npx -y inspector一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你写了一个工具，Claude 不使用它，你不知道原因。
结果： 具体原因（错误的工具描述、模式问题、模型选择）以及可见的修复。
何时使用： 你想在 CI 中捕捉'哎呀，那个提示不再选择我的工具'的情况。
结果： 破坏工具选择的 PR 不会合并。
何时使用： 令牌没有刷新，或重定向返回 400。
结果： 符合规范的 OAuth 实现。
在你的 MCP 服务器 PR 的 GitHub Action 中运行 Inspector 评估
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| (inspector app) connect-server | transport: stdio|http, command or url | 第一步 | free |
| (inspector app) execute-tool | tool, args | 手动测试 | depends on tool |
| (inspector app) chat-and-inspect | model, prompt | 端到端模拟 | 1 LLM call |
| (inspector app) run-evals | suite_id | CI 回归测试 | N LLM calls |
你的 MCP 服务器需要的任何作用域 评估的 LLM 提供者密钥不要未经审查就将生产 OAuth 客户端机密上传到托管应用无法连接到我的 stdio 服务器确保 Inspector 运行的命令与 Claude Desktop 运行的命令匹配——包括工作目录和环境变量。
Chat 标签页显示'model not configured'在 Settings 中添加你的 Anthropic/OpenAI 密钥。
评估在本地通过，在 CI 中失败环境不匹配——在 CI 中锁定与本地相同的模型 + 温度。
OAuth 测试报告'state mismatch'你的服务器没有保留状态参数；与 Inspector 的合规性报告中的规范进行比较。
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| @modelcontextprotocol/inspector (官方) | 你想要第一方参考检查器 | 功能表面较小；没有评估/CI |
| mcp-client-for-ollama | 你想要仅终端的 Ollama 支持的客户端 | 不是调试器，只是一个客户端 |