MCP Debug CLI
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
- 38 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Утилита подключается к указанному серверу и вызывает его инструменты, а они могут менять данные
- В режиме OAuth открывается вход в учетную запись сервера
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mcp-debugОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Утилита подключается к указанному серверу и вызывает его инструменты, а они могут менять данные
- В режиме OAuth открывается вход в учетную запись сервера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`mcp-debug` подключается к MCP-серверу по транспорту `streamable-http` и показывает, что он умеет: инструменты, ресурсы и промпты. В интерактивном режиме `--repl` их можно вызывать вручную. Подробный лог сообщений JSON-RPC включается отдельно, поэтому видно, какие сообщения ушли на сервер и что вернулось. Уведомления сервера утилита слушает сама. Для защищенных серверов есть вход по OAuth 2.1 по спецификации MCP от 25 ноября 2025 года. Утилита находит сервер авторизации, проверяет поддержку PKCE, привязывает токен к ресурсу, а для идентификации использует документ клиента CIMD либо динамическую регистрацию. Права доступа выбираются автоматически или вручную, при нехватке прав возможно повышение. Флаг `--mcp-server` превращает инструмент в MCP-сервер для Cursor и других клиентов. Остальное: самообновление и скрипты автодополнения для Bash, Zsh, Fish и PowerShell.
Для кого. Авторам MCP-серверов и командам, которые разбираются, почему агент не видит инструмент или не проходит авторизацию.
Подходит, если
- Новый MCP-сервер запущен, и нужно увидеть его инструменты и схемы до подключения к агенту
- Агент не вызывает инструмент, и вы проверяете сырые сообщения JSON-RPC между клиентом и сервером
- Сервер за OAuth отвечает отказом, а вы хотите пройти вход вручную и посмотреть обнаружение и выбор прав
- Нужно посмотреть, какие уведомления сервер шлет клиенту
Не подходит, если
- Сервер работает только по stdio: утилита подключается по `streamable-http`
- Нужен веб-интерфейс с историей вызовов: для этого есть MCP Inspector
- Требуется нагрузочное тестирование или автотесты в CI: REPL и логи рассчитаны на ручную отладку
Пример запроса к агенту
Подключись к http://localhost:8090/mcp, перечисли инструменты сервера и вызови первый из них с тестовыми аргументами.Ограничения
Поддерживается транспорт `streamable-http`, серверы на stdio утилита не открывает.
Установка идет через `go install`, нужен Go. Готовых бинарников README не обещает.
В режиме OAuth браузер открывается на странице согласия. Для клиента на экране согласия показывается название MCP Debugger CLI.
Подробности по OAuth и расширенным сценариям лежат в `docs/usage.md` и `docs/oauth/`, в самом README их нет.
Как отключить. Удалите бинарник `mcp-debug` из каталога `GOBIN` или `$GOPATH/bin`. Если подключали режим `--mcp-server`, уберите запись из конфига клиента.
Частые вопросы
Как установить mcp-debug?
Выполните `go install github.com/giantswarm/mcp-debug@latest`. Бинарник появится в каталоге Go для исполняемых файлов, проверьте, что он есть в `PATH`.
Как подключиться к серверу с OAuth?
Запустите `mcp-debug --oauth --endpoint <адрес>`. Утилита сама найдет сервер авторизации, откроет браузер для согласия и подключится с токеном, привязанным к ресурсу.
Что такое CIMD?
Это документ с метаданными клиента по ссылке, который сервер авторизации скачивает вместо предварительной регистрации. Свой документ задают флагом `--oauth-client-id-metadata-url`, а динамическую регистрацию включают через `--oauth-disable-cimd`.
Работает ли утилита с серверами на stdio?
Нет, поддерживается транспорт `streamable-http`. Для сервера на stdio понадобится другой отладчик, например MCP Inspector.
Можно ли подключить mcp-debug к Cursor?
Можно: флаг `--mcp-server` запускает утилиту как MCP-сервер. Конкретный конфиг клиента в README не приведен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПрозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Консольный инспектор HTTP-серверов MCP: покажет инструменты, схемы, промпты и ресурсы и вызовет любой инструмент вручную.
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Клиент в терминале и браузере открывает чат с моделью Anthropic и любым MCP-сервером, чтобы проверить его инструменты.
Легкий CLI, чтобы находить, смотреть и вызывать инструменты MCP-серверов прямо из командной строки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| MCP Debug (эта карточка) | да | 38 | |
| MCP Inspector | нет | 11 243 | веб-интерфейс, CLI и терминальный UI вместо одного REPL |
| mcp-cli | нет | 1 282 | легкий вызов инструментов из командной строки без разбора авторизации |
Коротко о README
README перечисляет возможности и дает быстрый старт для OAuth с примерами флагов. Подробные руководства вынесены в `docs/usage.md` и каталог `docs/oauth/`.