MCP Inspector

Отладка и тестирование MCP серверов — официальный инструмент для разработки и диагностики

Обзор

MCP Inspector — официальный инструмент для тестирования и отладки MCP серверов. Он позволяет интерактивно исследовать capabilities сервера, вызывать инструменты и диагностировать проблемы.

Архитектура

Inspector состоит из двух компонентов:

┌─────────────────────────────────────────────────────────┐
│                    MCP Inspector                        │
├─────────────────────────┬───────────────────────────────┤
│   MCPI (Client)         │   MCPP (Proxy)               │
│   React Web UI          │   Node.js Server             │
│   localhost:6274        │   localhost:6277             │
├─────────────────────────┼───────────────────────────────┤
│   • Интерактивный UI    │   • Протокольный мост        │
│   • Просмотр tools      │   • Управление транспортами  │
│   • Вызов методов       │   • Логирование сообщений    │
│   • История запросов    │   • Авторизация              │
└─────────────────────────┴───────────────────────────────┘
                              │
                              v
                    ┌─────────────────┐
                    │   MCP Server    │
                    │   (ваш сервер)  │
                    └─────────────────┘

Требования

Node.js >= 22.7.5
Для некоторых серверов: Python / uvx

Быстрый старт

Базовый запуск

# Запуск Inspector UI (откроется http://localhost:6274)
npx @modelcontextprotocol/inspector

# Запуск с конкретным сервером
npx @modelcontextprotocol/inspector node build/index.js

# Python сервер
npx @modelcontextprotocol/inspector uvx mcp-server-fetch

Передача переменных окружения

# Одна переменная
npx @modelcontextprotocol/inspector -e API_KEY=sk-xxx node server.js

# Несколько переменных
npx @modelcontextprotocol/inspector \
  -e API_KEY=sk-xxx \
  -e DEBUG=true \
  python -m my_server

Кастомные порты

# Изменить порты по умолчанию
CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector node build/index.js

Web UI интерфейс

Resources

Просмотр ресурсов сервера

Tools

Список и вызов инструментов

Prompts

Тестирование подсказок

Logs

JSON-RPC сообщения

Вкладки интерфейса

Вкладка	Описание
Resources	Список ресурсов, чтение содержимого
Tools	Вызов инструментов с параметрами
Prompts	Получение prompt с аргументами
Messages	Полный лог JSON-RPC коммуникации
Notifications	Server notifications

CLI режим

Для автоматизации и скриптов используйте CLI режим:

Получение списка tools

npx @modelcontextprotocol/inspector --cli node build/index.js \
  --method tools/list

Вызов инструмента

npx @modelcontextprotocol/inspector --cli node build/index.js \
  --method tools/call \
  --tool-name get_weather \
  --tool-arg location=Moscow

Работа с ресурсами

# Список ресурсов
npx @modelcontextprotocol/inspector --cli node build/index.js \
  --method resources/list

# Чтение ресурса
npx @modelcontextprotocol/inspector --cli node build/index.js \
  --method resources/read \
  --resource-uri "file:///project/config.json"

Подключение к HTTP серверу

npx @modelcontextprotocol/inspector --cli https://my-server.example.com \
  --transport http \
  --method tools/list

Файл конфигурации

Создайте mcp.json для сохранения настроек серверов:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"],
      "env": {}
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "remote-api": {
      "type": "sse",
      "url": "http://localhost:3000/sse"
    },
    "http-server": {
      "type": "streamable-http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

Запуск с конфигурацией:

# Запустить конкретный сервер из конфига
npx @modelcontextprotocol/inspector --config mcp.json --server filesystem

# Или выбрать в UI
npx @modelcontextprotocol/inspector --config mcp.json

Docker

Запуск в контейнере

docker run --rm \
  -p 127.0.0.1:6274:6274 \
  -p 127.0.0.1:6277:6277 \
  -e HOST=0.0.0.0 \
  -e MCP_AUTO_OPEN_ENABLED=false \
  ghcr.io/modelcontextprotocol/inspector:latest

Docker Compose

version: "3.8"
services:
  mcp-inspector:
    image: ghcr.io/modelcontextprotocol/inspector:latest
    ports:
      - "127.0.0.1:6274:6274"
      - "127.0.0.1:6277:6277"
    environment:
      - HOST=0.0.0.0
      - MCP_AUTO_OPEN_ENABLED=false
    restart: unless-stopped

Тестирование локального сервера из Docker

# Монтируем сервер и запускаем
docker run --rm -it \
  -p 6274:6274 \
  -p 6277:6277 \
  -v /path/to/server:/app/server \
  -e HOST=0.0.0.0 \
  ghcr.io/modelcontextprotocol/inspector:latest \
  node /app/server/build/index.js

Транспорты

Inspector поддерживает все MCP транспорты:

По умолчанию — запуск сервера как subprocess

npx @modelcontextprotocol/inspector node server.js

Использует stdin/stdout для коммуникации.

Server-Sent Events — для HTTP серверов

npx @modelcontextprotocol/inspector --transport sse http://localhost:3000/sse

Рекомендуемый HTTP транспорт

npx @modelcontextprotocol/inspector --transport http http://localhost:3001/mcp

Современный транспорт с поддержкой сессий и OAuth.

Конфигурация

Переменные окружения

Переменная	Описание	По умолчанию
`CLIENT_PORT`	Порт Web UI	6274
`SERVER_PORT`	Порт Proxy	6277
`HOST`	Bind адрес	127.0.0.1
`MCP_AUTO_OPEN_ENABLED`	Открывать браузер	true
`MCP_SERVER_REQUEST_TIMEOUT`	Таймаут запроса (ms)	300000
`MCP_REQUEST_MAX_TOTAL_TIMEOUT`	Макс. общий таймаут	60000
`MCP_PROXY_FULL_ADDRESS`	Кастомный адрес proxy	""

Отключение автооткрытия

MCP_AUTO_OPEN_ENABLED=false npx @modelcontextprotocol/inspector node server.js

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

Защитные механизмы

Session Token — генерируется при запуске, требуется для доступа
Localhost Binding — по умолчанию привязан к 127.0.0.1
DNS Rebinding Protection — валидация Origin заголовков
CORS Policy — ограничение cross-origin запросов

Удалённый доступ

Для доступа извне (только для разработки!):

# Разрешить внешние подключения
HOST=0.0.0.0 npx @modelcontextprotocol/inspector node server.js

Примеры использования

Тестирование Filesystem сервера

# Запуск
npx @modelcontextprotocol/inspector \
  npx -y @modelcontextprotocol/server-filesystem /home/user/docs

# В UI:
# 1. Перейти на вкладку Tools
# 2. Выбрать list_directory
# 3. Указать path: /home/user/docs
# 4. Нажать Execute

Тестирование Git сервера

npx @modelcontextprotocol/inspector \
  uvx mcp-server-git --repository /path/to/repo

# Доступные инструменты:
# - git_status
# - git_log
# - git_diff

Тестирование Memory сервера

npx @modelcontextprotocol/inspector \
  -e MEMORY_FILE_PATH=/tmp/memory.jsonl \
  npx -y @modelcontextprotocol/server-memory

# Тест:
# 1. tools/call → create_entities
# 2. tools/call → read_graph

Отладка кастомного сервера

# Добавить отладочный вывод
DEBUG=* npx @modelcontextprotocol/inspector node --inspect my-server.js

# Просмотр всех JSON-RPC сообщений во вкладке Messages

Типичные проблемы

Сервер не запускается

# Проверить команду напрямую
node build/index.js

# Проверить права на исполнение
chmod +x server.js

# Проверить зависимости
npm install

Таймаут запросов

# Увеличить таймаут
MCP_SERVER_REQUEST_TIMEOUT=600000 npx @modelcontextprotocol/inspector ...

Порт занят

# Использовать другие порты
CLIENT_PORT=7000 SERVER_PORT=7001 npx @modelcontextprotocol/inspector ...

Проблемы с SSE

# Проверить CORS на сервере
# Убедиться что endpoint возвращает правильные заголовки:
# Cache-Control: no-cache
# Connection: keep-alive

IDE интеграции

MCP Inspector работает совместно с IDE плагинами:

JetBrains

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Поддерживаемые IDE: IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, Rider, Android Studio.

VS Code

VS Code имеет встроенную поддержку MCP через GitHub Copilot расширение.

Cursor / Windsurf

Оба редактора поддерживают MCP нативно через конфигурацию в настройках.

Best Practices

Разработка

Запускайте Inspector рядом с IDE — быстрая итерация
Используйте CLI для CI/CD — автоматизация тестов
Сохраняйте конфиги в mcp.json — переиспользуемость
Мониторьте Messages — понимание протокола

Отладка

Проверяйте capabilities — что сервер объявляет
Тестируйте edge cases — пустые входы, большие данные
Следите за ошибками — JSON-RPC error codes
Логируйте на сервере — stderr для отладки

Production

Не используйте Inspector в prod — только для разработки
Тестируйте с реальными данными — до деплоя
Документируйте tools — описания и примеры
Версионируйте API — breaking changes

Следующие шаги

MCP SDK — создание своих серверов
Официальные серверы — готовые решения
n8n MCP серверы — интеграция с n8n