mcp2cli
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может вызывать операции записи во внешних API, включая POST-запросы и мутации GraphQL
- Через --mcp-stdio запускает произвольные серверные команды и хранит OAuth-токены и секреты в кеше
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mcp2cliОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Установите утилиту
pipx install mcp2cliБез pipx подойдет pip install mcp2cli.
Установи CLI: uv tool install mcp2cli, или запусти без установки через uvx mcp2cli --help. Скилл для агента: npx skills add knowsuchagency/mcp2cli --skill mcp2cli. Затем подключайся к источнику флагом --mcp, --spec или --graphql и смотри команды через --list.
Другие способы из описания автора
uv tool install mcp2cliГлобальная установка через uv. Разово можно запустить без установки: uvx mcp2cli --help. Также доступен pip install mcp2cli.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp2cli подключается к источнику, будь то MCP-сервер по HTTP, SSE или stdio, спецификация OpenAPI или GraphQL-эндпоинт, и строит из него команды прямо во время запуска. Флаг --list показывает доступные операции, --search ищет их по имени и описанию, а вызов команды с флагами выполняет операцию. Поддерживаются OAuth с потоками authorization code и client credentials, передача секретов через префиксы env и file, кеширование, сохранение готовых подключений через bake и вывод в JSON или компактный формат TOON. Для агентов важна экономия контекста: инструмент сам ранжирует список по частоте вызовов и умеет отдавать только имена команд, что снижает расход токенов на схемы. В комплекте идет скилл, который учит Claude Code, Cursor и Codex пользоваться mcp2cli и даже собирать новые скиллы из API.
Для кого. Для разработчиков и инженеров, которые хотят вызывать MCP-серверы и API из терминала и давать эти команды агенту без лишнего расхода контекста.
Подходит, если
- Нужно быстро вызвать инструмент MCP-сервера или эндпоинт API из командной строки
- Нужно сократить расход токенов на схемы инструментов у агента
- Нужно собрать скилл или обертку вокруг стороннего API без написания кода
Не подходит, если
- Нужен постоянный сервис с собственной логикой, а не разовые вызовы
- У целевого API нет спецификации OpenAPI, GraphQL-интроспекции или интерфейса MCP
Пример запроса к агенту
Покажи список инструментов этого MCP-сервера через mcp2cli и вызови поиск по слову задачаОграничения
Нужен Python версии 3.10 и выше, ставится через uv или pip. Возможности зависят от того, к какому серверу или API вы подключаетесь: mcp2cli сам ничего не хостит. Доступность конкретного удаленного API из России зависит от самого сервиса. OAuth-токены и кеш хранятся в ~/.cache/mcp2cli, поэтому относитесь к этой папке как к чувствительным данным.
Как отключить. Удалите инструмент: uv tool uninstall mcp2cli или pip uninstall mcp2cli. Скилл удаляется из каталога скиллов вашего агента.
Проверка безопасности
- Может вызывать операции записи во внешних API, включая POST-запросы и мутации GraphQL
- Через --mcp-stdio запускает произвольные серверные команды и хранит OAuth-токены и секреты в кеше
Коротко о README
README представляет mcp2cli как единый CLI для MCP-серверов, спецификаций OpenAPI и GraphQL-эндпоинтов, который работает во время запуска и без генерации кода. Показаны установка через uvx и uv tool install, режимы HTTP, SSE и stdio для MCP, работа с OpenAPI и GraphQL, потоки OAuth, передача секретов через env и file, кеширование и сохранение подключений через bake. Отдельно описаны экономия токенов за счет ранжирования и компактного вывода, режимы JSON и TOON и совместимость сразу с двумя мажорными версиями MCP SDK. В комплекте идет скилл для Claude Code, Cursor и Codex. Лицензия MIT.
Частые вопросы
Нужно ли генерировать код под каждый API?
Нет. mcp2cli читает спецификацию или интроспектирует эндпоинт во время запуска и строит команды на лету, генерация кода не нужна.
Как это экономит токены агенту?
Инструмент ранжирует список команд по частоте вызовов и умеет отдавать только имена или компактный формат TOON, поэтому агент не тянет полные схемы всех инструментов в контекст на каждом шаге.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента