MCP Gateway
Один шлюз на Rust между агентом и всеми MCP-серверами: клиент видит 9–17 мета-инструментов, а остальные находит по запросу.
- 84 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Шлюз хранит переменные окружения и ключи всех подключенных серверов
- Мастер настройки перезаписывает конфигурации Claude Code, Cursor и других клиентов
- Сетевой запуск открывает порт, доступ защищает только токен
Установка
- Работает в
Ручная установка
brew install MikkoParkkola/tap/mcp-gatewayРекомендуемый способ для macOS и Linux. Перед этим выполните `brew trust --tap MikkoParkkola/tap` на Homebrew 6.0 и новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Шлюз хранит переменные окружения и ключи всех подключенных серверов
- Мастер настройки перезаписывает конфигурации Claude Code, Cursor и других клиентов
- Сетевой запуск открывает порт, доступ защищает только токен
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP Gateway запускается одним бинарным файлом и подключается к клиенту как один MCP-сервер. За ним стоят ваши MCP-серверы и REST API. Вместо сотни описаний инструментов агент получает компактный набор: `gateway_search_tools` ищет нужный инструмент по запросу, `gateway_invoke` вызывает его. В поставке 110 с лишним готовых описаний REST-возможностей, а еще один API подключается файлом YAML или импортом спецификации OpenAPI. Мастер `mcp-gateway setup wizard --configure-client` находит серверы в Claude Desktop, Claude Code, Cursor, Zed, Continue.dev и Codex, переносит их в `gateway.yaml` и прописывает шлюз в конфигурации клиентов с резервной копией. Команда `mcp-gateway doctor` проверяет конфигурацию, порт, переменные окружения и состояние серверов. Проверка описаний инструментов на отравление выполняется до того, как они дойдут до агента.
Для кого. Тем, кто подключил к Claude Code, Cursor или Codex десятки MCP-серверов и теряет контекст на описаниях инструментов.
Подходит, если
- К агенту подключено 20 серверов и сотня инструментов, и описания съедают контекст раньше первого вопроса
- Одни и те же серверы нужны сразу в Claude Code, Cursor и Codex, а настраивать каждый клиент по отдельности лень
- Внутренний REST API надо показать агенту, не оформляя его отдельным MCP-сервером
- Перед запуском хочется проверить конфигурацию, порт и состояние серверов командой `mcp-gateway doctor`
Не подходит, если
- Серверов два-три, и их описания помещаются в контекст: лишний переход через поиск добавит ходов
- Нужна экономия токенов на каждой задаче: в замере автора мета-режим расходовал на 1,2–16,1 процента больше входных токенов и добавлял один ход
- Шлюз нужен в коммерческом проекте без отдельной лицензии: для такого случая бесплатного разрешения нет
Пример запроса к агенту
Установи mcp-gateway, перенеси мои MCP-серверы за один шлюз и покажи, какие инструменты остались видны агенту.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
MCP_GATEWAY_CONFIG_DIR- Каталог данных и конфигурации шлюза, по умолчанию `~/.mcp-gateway`.
Ограничения
Лицензия PolyForm Noncommercial 1.0.0: бесплатно можно работать в личных и некоммерческих целях, для коммерческой работы нужна отдельная лицензия. Автор пишет, что выигрыш дает емкость каталога, политики и маршрутизация, а общая экономия токенов не доказана. Шлюз хранит доступы ко всем вашим серверам и меняет конфигурации клиентов. Сетевой запуск требует токена, перед записью в конфигурацию клиента используйте `--dry-run`.
Как отключить. Верните клиентам прежние конфигурации командой `mcp-gateway setup export --rollback <файл копии>`, затем остановите шлюз и удалите его бинарный файл. Каталог данных по умолчанию лежит в `~/.mcp-gateway`.
Частые вопросы
Как подключить шлюз к Claude Code?
Запустите мастер `mcp-gateway setup wizard --configure-client` или `mcp-gateway setup export --target claude-code`. Шлюз запишется в `~/.claude.json`, старый файл сохранится копией, а команда восстановления выведется рядом.
Как добавить новый сервер?
Команда `mcp-gateway add tavily` берет известный сервер из встроенного реестра на 48 позиций. Произвольный запуск добавляется так: `mcp-gateway add my-server -- npx -y @some/mcp-server`. Команда совместима с `claude mcp add`.
Правда ли, что шлюз экономит токены?
В замере автора нет: оба режима выполнили все задачи, а мета-режим использовал на 1,2–16,1 процента больше входных токенов и добавил ход. Ценность в большом каталоге без раздувания списка инструментов.
Где смотреть состояние шлюза?
После `mcp-gateway serve` веб-панель открывается по адресу `http://localhost:39400/ui`. Панель оператора `/dashboard` требует учетных данных администратора, ссылку для входа печатает сам запуск.
Какие способы установки есть?
Homebrew, `cargo install mcp-gateway`, `cargo binstall mcp-gateway`, готовый бинарный файл для Windows x64 и образ Docker. Для Docker с серверами на npx или uvx нужен тег `latest-full`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный шлюз MCP: серверы подключаются один раз и работают в Claude Code, Codex, Cursor и других агентах, ключи лежат в связке ОС
Менеджер на Rust собирает MCP-сервисы под одним демоном: CLI, веб-интерфейс, HTTP API и SDK для Python и Rust
Почтовый сервер для агентов на одном репозитории: письма, ветки переписки, брони файлов и 16-экранный TUI
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
CLI mcpl ищет инструменты сразу по нескольким MCP-серверам и вызывает их из терминала, а вход по OAuth делает человек
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
Коротко о README
Описание начинается с проблемы: каждый подключенный инструмент стоит около 150 токенов контекста в каждом запросе. Затем идут схема работы, быстрый старт в четыре команды, три способа настройки, таблица путей конфигурации клиентов и раздел о безопасности. Отдельно описаны лицензия и коммерческие условия.