🚀 Горячий релизTypeScript

MCPJam /

inspector

Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps.

Открыть на GitHub

Форки

233

Звёзды

2.0k

Issues

Инструмент для тестирования и отладки MCP-серверов и AI-приложений. Позволяет проверять запросы, ответы и работу инструментов в реальном времени.

Что делает

Inspector помогает понять, почему твой AI-агент тупит или выдает ошибку. Это визуальный отладчик, который показывает, что именно происходит между клиентом и MCP-сервером. Ты видишь все вызовы функций, аргументы и ответы модели без необходимости лезть в логи консоли.

Продукт закрывает главную боль вайб-кодера — отсутствие прозрачности в работе AI-агентов. Он превращает процесс отладки в понятный чат с историей транзакций. Ты сразу видишь, где сломалась логика: на этапе формирования промпта или при выполнении функции.

Как работает

Инструмент подключается к твоему MCP-серверу как клиент и имитирует запросы. Он перехватывает трафик и визуализирует обмен данными в интерфейсе. Это позволяет тестировать интеграции с Anthropic или OpenAI в изолированной среде.

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

Кому подходит

Разработчикам AI-агентов на базе MCP, которым нужно быстро проверять работоспособность функций.

Тем, кто интегрирует сторонние MCP-серверы и хочет убедиться, что они отдают корректные данные.

Вайб-кодерам, собирающим сложные цепочки инструментов, где важно ловить ошибки на лету.

Людям, которые делают собственные GPTs и хотят тестировать их логику до публикации.

Основные возможности

Просмотр всех вызовов инструментов и их аргументов.

Интерактивный чат для быстрой проверки логики агента.

Поддержка отладки OAuth-потоков для защищенных сервисов.

Инструменты для оценки (evals) качества ответов модели.

Логирование всей истории взаимодействия для анализа ошибок.

Поддержка работы с локальными и удаленными MCP-серверами.

Как установить

Для запуска используй npx. Это самый быстрый способ начать работу без установки лишних зависимостей.

npx @modelcontextprotocol/inspector <команда_запуска_твоего_сервера>

Убедись, что твой MCP-сервер доступен в системе. Inspector подхватит его и откроет интерфейс в браузере.

Как применить в своём продукте

Используй Inspector как основной инструмент для QA перед деплоем. Если ты строишь SaaS с AI-функциями, прогоняй через него каждый новый инструмент, чтобы убедиться в стабильности API.

Интегрируй в CI/CD пайплайн для автоматической проверки корректности ответов MCP-сервера.

Используй для демонстрации работы своего API заказчикам или пользователям.

Заменяй стандартные логи на визуальную отладку, чтобы быстрее находить баги в промптах.

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

Главная сложность — настройка окружения. Inspector требует, чтобы твой MCP-сервер корректно отдавал спецификации. Если сервер падает при старте или не проходит валидацию протокола, отладчик просто не увидит инструменты. Учитывай, что работа с OAuth может потребовать дополнительных правок в конфигах.

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

Нужно ли мне знать TypeScript, чтобы пользоваться Inspector?

Нет. Ты используешь его как готовый инструмент. Достаточно знать, как запустить свой MCP-сервер через терминал. Inspector просто подключается к нему и показывает, что происходит внутри.

Можно ли использовать Inspector с приватными API?

Да, он поддерживает авторизацию, включая OAuth. Главное — правильно настроить переменные окружения при запуске, чтобы Inspector мог авторизоваться от твоего имени.

Поможет ли это улучшить качество ответов моего бота?

Да. Инструмент позволяет видеть, какие именно данные получает модель. Если ты видишь, что аргументы передаются неверно, ты быстрее исправишь промпт, что напрямую поднимет качество ответов.

Топики

anthropic chatgpt cicd debugger evals evaluation inspector mcp mcp-apps mcp-clients mcp-inspector mcp-server mcp-tools modelcontextprotocol oauth oauth2 openai openai-apps-sdk opensource tracing