OpenMCP Client CLI
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
- 750 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Инструмент запускает локальные процессы MCP-серверов и вызывает их инструменты с теми правами, которые есть у вашего пользователя
- Для проверки через модель тексты запросов и ответы инструментов уходят выбранному провайдеру, и нужен его ключ API
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/openmcp-clientОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент запускает локальные процессы MCP-серверов и вызывает их инструменты с теми правами, которые есть у вашего пользователя
- Для проверки через модель тексты запросов и ответы инструментов уходят выбранному провайдеру, и нужен его ключ API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenMCP объединяет инспектор MCP-серверов и клиент с чатом в одном инструменте. Вы подключаете сервер, проверяете его инструменты, промпты и ресурсы, затем переносите проверенные инструменты в раздел интерактивного тестирования и гоняете их через языковую модель. Поддерживаются DeepSeek, OpenAI, Qwen, Gemini, Grok, Mistral, MiniMax, Groq, Perplexity, Kimi, Ollama, OpenRouter и любые OpenAI-совместимые серверы. Можно отлаживать несколько MCP-серверов одновременно и сохранять результаты отладки. Инструмент ставится как расширение для VS Code, Trae и Cursor. Для терминала есть CLI `openmcp` из npm-пакета `@agent-ruler/openmcp`: `openmcp gateway start` поднимает шлюз на `ws://localhost:8282`, а группы команд `mcp`, `debug`, `setting` и `skills` управляют конфигурацией серверов, вызовами инструментов и настройками моделей. `openmcp start` открывает веб-интерфейс. В репозитории лежит скилл `agent-ruler-openmcp`, который учит агента ставить пакет, запускать шлюз, диагностировать установку и пользоваться командами CLI. Когда отладка закончена, пакет `openmcp-sdk` превращает проверенный набор серверов и промптов в агентское приложение на TypeScript.
Для кого. Для авторов MCP-серверов и тех, кто подключает чужие, если нужно проверить инструменты и промпты вручную и через модель, прежде чем отдать сервер агенту.
Подходит, если
- Вы пишете MCP-сервер и хотите вызывать его инструменты с разными аргументами, не запуская агента
- Нужно убедиться, что языковая модель правильно выбирает инструмент и подставляет параметры, и сравнить это у нескольких моделей
- В скрипте или CI надо вызвать `openmcp debug tool call` и проверить ответ сервера
- Агент должен сам поставить `openmcp`, запустить шлюз и показать логи, если запуск не удался
- Отлаженную связку серверов и промптов нужно развернуть как готового агента на TypeScript через `openmcp-sdk`
Не подходит, если
- Вам нужен только официальный минимальный инспектор протокола: у OpenMCP больше функций, в том числе чат и управление проектами
- Работа идет без Node.js 18 или новее: CLI и шлюз без него не запустятся
- Нужна защита от опасных операций: подтверждения перед опасными вызовами пока нет, в дорожной карте пункт не закрыт
- Подключенный MCP-сервер нужно обновлять без перезапуска: горячего обновления пока нет
Пример запроса к агенту
Подключи мой MCP-сервер из mcp-server.json через openmcp и вызови инструмент echo с аргументом message=hi.Ограничения
Для CLI нужен Node.js 18 или новее, и большинство команд требуют запущенного шлюза на порту 8282 по умолчанию. При другом порте к командам добавляют ключ `-g ws://127.0.0.1:9000`. Документация и часть руководств написаны по-китайски.
Расширение выходит для VS Code, Trae и Cursor, в других редакторах остаются CLI и веб-интерфейс `openmcp start`. Модели по собственному протоколу автор пока не подключил, для проверки через модель нужен ключ API выбранного провайдера. Последнее обновление репозитория — 4 июня 2026 года.
Как отключить. Остановите шлюз командой `openmcp gateway stop` и удалите пакет командой `npm uninstall -g @agent-ruler/openmcp`. Расширение отключается в списке расширений VS Code, Trae или Cursor.
Частые вопросы
Как установить OpenMCP из npm?
Выполните `npm install -g @agent-ruler/openmcp` и проверьте `openmcp --version`. Затем запустите шлюз командой `openmcp gateway start`: большинство команд работают только с ним.
Как добавить MCP-сервер и вызвать его инструмент через `openmcp`?
Добавьте сервер из файла командой `openmcp mcp server add --file ./mcp-server.json`, подключитесь через `openmcp mcp session connect --id <serverId>`, затем вызовите инструмент: `openmcp debug tool call --name echo --args "{\"message\":\"hi\"}"`.
Какие модели поддерживает OpenMCP для проверки инструментов?
DeepSeek, OpenAI, Qwen, Gemini, Grok, Mistral, MiniMax, Groq, Perplexity, Kimi, Ollama, OpenRouter и любые OpenAI-совместимые серверы.
Что делать, если шлюз `openmcp gateway` не запускается?
Запустите шлюз в переднем плане командой `openmcp gateway run -p 8282`, чтобы увидеть вывод в терминале, и посмотрите журналы: `openmcp gateway logs -n 200` покажет `gateway.log` и `gateway-startup.log`, а `openmcp gateway logs-dir` назовет каталог.
Чем OpenMCP отличается от MCP Inspector?
MCP Inspector проверяет протокол сервера. OpenMCP добавляет чат с языковой моделью, управление проектами, одновременную отладку нескольких серверов, сохранение результатов и CLI для скриптов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПрозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
Официальный сервер MCP от Microsoft для отладки: расширение VS Code и CLI дают агенту точки останова, шаги, переменные и вычисление выражений
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
OpenMCP превращает любую OpenAPI-спецификацию в MCP-сервер и дает выбрать, какие инструменты показывать агенту
CLI и TypeScript-рантайм для вызова MCP-серверов из терминала, скриптов и сгенерированных типизированных клиентов
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Коротко о README
Снимки экрана и видео показывают работу расширения: инспектор, ресурсы, чат, управление проектами, выбор моделей и режим XML. Дальше идут пример развертывания агента через `openmcp-sdk` и таблица дорожной карты с процентами готовности. Для CLI есть отдельное описание с примерами и ссылками на справочник команд.