MCPJam Inspector (MCP server) — Сценарии использования, Установка & Живое демо

Name: MCPJam Inspector MCP Server
Author: MCPJam

Зачем использовать

Ключевые функции

Подключение к любому MCP-транспорту: stdio / SSE / streamable HTTP
Ручной вызов любого инструмента через форму с live-валидацией JSON Schema
Встроенный чат, использующий инструменты сервера — видно, как LLM реально их применяет
Режим eval: запускайте prompt против нескольких моделей, сравнивайте трассировки использования инструментов
Работает и для ChatGPT-приложений, не только для MCP-серверов

Живое демо

Как выглядит на практике

mcpjam-inspector.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcpjam-inspector",
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcpjam-inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mcpjam/inspector"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcpjam-inspector -- npx -y @mcpjam/inspector

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: MCPJam Inspector

Отладка неправильных вызовов MCP-инструмента

👤 Авторы MCP-серверов ⏱ ~20 min intermediate

Когда использовать: Вы выпустили инструмент, а Claude постоянно вызывает его с неправильными аргументами.

Предварительные требования

Запущенный Inspector — npx -y @mcpjam/inspector (открывает браузер на localhost:6274)
Ваш MCP-сервер — Готов к запуску через stdio-команду или SSE URL

Поток

Подключить сервер

In the inspector UI, add a stdio server: command=node, args=[./dist/server.js].✓ Скопировано

→ Появляется список инструментов с описаниями и схемами
Посмотреть на сервер глазами LLM

Look at the rendered description in the tool detail panel — that's exactly what the model sees.✓ Скопировано

→ Замечаете неоднозначность («id» должно быть «task_id», или отсутствует пример)
Воспроизвести неправильный вызов

Open Chat tab. Send the user prompt that caused the failure. Watch the tool_use payload.✓ Скопировано

→ Тот же неверный вызов, что был в продакшне
Исправить описание, перетестировать

Update the tool's description and example in your server code, restart, retry the same prompt.✓ Скопировано

→ На этот раз — правильный вызов

Итог: Конкретное исправление, подкреплённое сравнением до/после.

Подводные камни

Устаревшая схема закешировалась после перезапуска сервера — Нажмите «Reconnect» в панели сервера; inspector заново запросит list_tools

Оценка работы вашего MCP-сервера на разных моделях

👤 Авторы серверов, ориентированных на несколько клиентов ⏱ ~45 min advanced

Когда использовать: Хотите знать, работает ли ваш сервер с Sonnet так же хорошо, как с Haiku/GPT-5.

Поток

Составить набор eval

Author 10 representative user prompts in the Eval tab. Mix easy and adversarial.✓ Скопировано

→ Eval сохранён с prompt-ами и ожидаемыми последовательностями инструментов
Запустить на нескольких моделях

Run the eval against Sonnet 4.6, Haiku 4.5, and GPT-5. Compare tool-use traces.✓ Скопировано

→ Трассировка на каждую модель; pass/fail по каждому prompt
Улучшить слабейшую схему

On the failing prompts, what description change would fix the cheaper model without breaking Sonnet?✓ Скопировано

→ Конкретная переработка описания

Итог: Сервер, работающий на всей линейке моделей, а не только на той, которую вы тестировали.

Подводные камни

Eval проверяет только «счастливый путь» — Добавьте adversarial prompt-ы: недостающие аргументы, противоречивые входные данные, неполная информация

Безопасное изучение незнакомого стороннего MCP-сервера

👤 Все, кто оценивает community MCP ⏱ ~15 min intermediate

Когда использовать: Рассматриваете добавление чужого MCP в конфигурацию и хотите сначала посмотреть, что он раскрывает.

Поток

Запустить изолированно

Add the server in inspector — don't put it in your real client config yet.✓ Скопировано

→ Инструменты перечислены с полными описаниями
Аудит поверхности

Scan tool list. Anything that writes/deletes/runs code? Anything that calls external URLs?✓ Скопировано

→ Список инструментов с категориями рисков
Вручную протестировать рискованные инструменты

Hand-call each write tool with a no-op payload to see what it actually does.✓ Скопировано

→ Вы подтверждаете поведение до передачи автономному агенту

Итог: Обоснованное решение установить или пропустить, а не слепое доверие.

Подводные камни

Инструмент выполняет shell-команды — даже ручной вызов может изменить систему — Запускайте в контейнере или в изолированной директории; никогда не проверяйте недоверенный MCP на рабочей машине

Комбинации

Сочетайте с другими MCP — эффект x10

mcpjam-inspector + github

Профилирование вашего MCP-сервера в CI

On every PR, run inspector eval against the main + PR head; comment diff in the PR via github MCP.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_tools	server connection	Запускается автоматически при подключении — редко вызывается вручную	0
call_tool	tool_name, args	Ручной вызов любого инструмента через форму	зависит от инструмента
chat	model, messages	Провести LLM через ваши инструменты и наблюдать за поведением	зависит от model API
run_eval	eval_set, models[]	Регрессионная проверка на нескольких моделях перед релизом	API-вызовы × модели × prompt-ы

Стоимость и лимиты

Во что обходится

Квота API: Режим eval использует квоты LLM-провайдеров — приносите свои ключи
Токенов на вызов: 0 для самого inspector; полная стоимость агента для chat/eval
Деньги: Бесплатно (open source) — платите только за model API
Совет: Используйте Haiku для итераций eval; переключайтесь на Sonnet только для финальной кросс-модельной проверки

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Только локальная сеть по умолчанию

Хранение учётных данных: API-ключи для eval-моделей хранятся в localStorage браузера по умолчанию — очищайте после использования на общих машинах

Исходящий трафик: Только к настроенным вами LLM-провайдерам (Anthropic, OpenAI и др.) и подключённым MCP-серверам

Никогда не давайте: Публичный доступ из интернета — держите inspector на localhost

Инспектирование вредоносного MCP-сервера всё равно выполняет код этого сервера на вашей машине — изолируйте незнакомых

Устранение неполадок

Частые ошибки и исправления

Сервер не подключается (stdio)

Убедитесь, что путь к команде абсолютный и рабочая директория задана; проверьте stderr в панели логов inspector

Проверить: Сначала запустите команду сервера вручную в терминале

SSE-сервер зависает при подключении

Проблема с CORS или заголовком авторизации — убедитесь, что SSE-эндпоинт принимает cross-origin запросы от localhost:6274

Проверить: curl -N <sse_url> with -H 'Accept: text/event-stream'

Eval запускается, но все модели проваливаются

Проверьте корректность API-ключа в настройках; убедитесь, что имена моделей соответствуют текущей номенклатуре провайдера

Порт inspector занят

PORT=6275 npx @mcpjam/inspector

Проверить: lsof -i :6274

Альтернативы

MCPJam Inspector в сравнении

Альтернатива	Когда использовать	Компромисс
modelcontextprotocol/inspector (официальный)	Нужен эталонный inspector с максимально консервативным набором функций	Нет режимов chat/eval; более низкоуровневый
wong2/mcp-cli	Предпочитаете терминал вместо UI	Нет визуального сравнения eval или рендеринга схем

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills