Repolode
Предложить
modelcontextprotocol

modelcontextprotocol/inspector

Визуальный инструмент и CLI для тестирования и отладки серверов Model Context Protocol (MCP) с веб-интерфейсом, CLI и терминальным UI.

Открыть на GitHubСайт
Звёзды
11,119
Форки
1,545
Открытые issues
26
Последний коммит
14 часов назад

Что это?

MCP Inspector позволяет разработчикам подключаться к серверам Model Context Protocol и изучать, что они предоставляют: инструменты, ресурсы и промпты. Их также можно вызывать напрямую, чтобы проверить работу. Пакет @modelcontextprotocol/inspector содержит один бинарный файл mcp-inspector с веб-интерфейсом (по умолчанию), CLI для написания скриптов и интерактивным терминальным UI.

Веб-интерфейс — это одностраничное приложение на Vite и React с бэкендом на Node, созданное с помощью Mantine. CLI предназначен для автоматизации и CI: сервер можно проверить на базовую работоспособность, подключившись к нему, получив список доступных возможностей, вызвав их и проверив результаты. Вывод в JSON можно использовать вместе с такими инструментами, как jq. В TUI для интерактивной работы в терминале используется Ink.

В пакет также входит экспериментальный бинарный файл mcpdo — CLI для подключений, который один раз подключается к указанному серверу, а затем выполняет множество команд через локальный демон. Секреты, например OAuth-токены и значения переменных окружения для stdio, хранятся в системном хранилище ключей, если оно доступно; в противном случае используется файловое хранилище.

Ключевые возможности

  • 01Веб-интерфейс для просмотра и вызова инструментов, ресурсов и промптов MCP-сервера
  • 02CLI для автоматизации, CI и smoke-тестов с выводом в JSON
  • 03Интерактивный терминальный UI на базе Ink
  • 04Хранение OAuth-токенов и секретов в системном хранилище ключей, если оно доступно
  • 05Экспериментальный CLI mcpdo для подключений, повторно использующий одно подключение для выполнения команд

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

  • Отладка собственного MCP-сервера во время разработки, до подключения его к AI-клиенту
  • Запуск в CI проверок MCP-сервера: подключение, получение списка, вызов и проверка результатов
  • Интерактивное и неинтерактивное тестирование MCP-серверов, защищённых OAuth
  • Изучение доступных инструментов незнакомого MCP-сервера и их входных параметров

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

  1. 1

    Запустите веб-интерфейс с помощью npx (установка не требуется)

    npx @modelcontextprotocol/inspector
  2. 2

    Или запустите вместо него клиент командной строки

    npx @modelcontextprotocol/inspector --cli

Что важно знать

  • Лицензия указана как NOASSERTION, а в README описан переходный период со смешанным лицензированием MIT и Apache-2.0, поэтому перед повторным использованием проверьте LICENSE.
  • На компьютерах без системного хранилища ключей такие секреты, как токены OAuth, сохраняются в незашифрованном виде в ~/.mcp-inspector/secrets.json, если не указать ключ.
  • Для разработки требуется Node версии 22.19.0 или новее.

Темы

#mcp#model-context-protocol#debugging#testing#cli#typescript#developer-tools#debug#tool#tui

Частые вопросы

Что такое inspector?
Визуальный инструмент и CLI для тестирования и отладки серверов Model Context Protocol (MCP) с веб-интерфейсом, CLI и терминальным UI. MCP Inspector позволяет разработчикам подключаться к серверам Model Context Protocol и изучать, что они предоставляют: инструменты, ресурсы и промпты. Их также можно вызывать напрямую, чтобы проверить работу. Пакет @modelcontextprotocol/inspector содержит один бинарный файл mcp-inspector с веб-интерфейсом (по умолчанию), CLI для написания скриптов и интерактивным терминальным UI.
inspector можно использовать бесплатно? Какая у него лицензия?
inspector распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
inspector всё ещё поддерживается?
Активно поддерживается. Последний коммит в inspector — 21 окт. 2026 г..
Для чего можно использовать inspector?
Отладка собственного MCP-сервера во время разработки, до подключения его к AI-клиенту Запуск в CI проверок MCP-сервера: подключение, получение списка, вызов и проверка результатов Интерактивное и неинтерактивное тестирование MCP-серверов, защищённых OAuth Изучение доступных инструментов незнакомого MCP-сервера и их входных параметров
Как установить inspector?
Запустите веб-интерфейс с помощью npx (установка не требуется): npx @modelcontextprotocol/inspector Или запустите вместо него клиент командной строки: npx @modelcontextprotocol/inspector --cli
Где скачать inspector?
Исходный код и инструкции по установке — на GitHub: https://github.com/modelcontextprotocol/inspector

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты