作者 MCPJam · MCPJam/inspector
建立 MCP 伺服器時，你會想要的除錯器 — JSON-RPC 追蹤、跨 LLM 的工具評估、OAuth 符合性、CI 整合。
MCPJam Inspector 是 MCP 伺服器的開發平臺。網路應用、桌面應用、終端機和 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 或 url | 第一步 | 免費 |
| (inspector app) execute-tool | tool、args | 手動測試 | 取決於工具 |
| (inspector app) chat-and-inspect | model、prompt | 端對端模擬 | 1 次 LLM 呼叫 |
| (inspector app) run-evals | suite_id | CI 迴歸測試 | N 次 LLM 呼叫 |
無論你的 MCP 伺服器需要什麼範圍 用於評估的 LLM 提供者金鑰不要將生產 OAuth 用戶端機密上傳到託管應用而不進行審查無法連接到我的 stdio 伺服器確保 Inspector 執行的命令與 Claude Desktop 執行的相符 — 包括工作目錄和環境變數。
聊天標籤說『模型未設定』在設定中新增你的 Anthropic/OpenAI 金鑰。
評估在本地通過，在 CI 中失敗環境不匹配 — 在 CI 中釘住與本地相同的模型 + 溫度。
OAuth 測試報告『state 不匹配』你的伺服器沒有保留 state 引數；與 Inspector 的符合性報告中的規範進行比較。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| @modelcontextprotocol/inspector (官方) | 你想要第一方參考 inspector | 較小的功能面；沒有評估/CI |
| mcp-client-for-ollama | 你想要一個終端機專用 Ollama 用戶端 | 不是除錯器，只是用戶端 |