MCP Gateway · mikkoparkkola — MCP-сервер для Claude Code: шлюз и маршрутизация
MCP Gateway — MCP-сервер, который прячет каталог инструментов за компактным набором мета-инструментов и вызывает бэкенды по требованию.
лицензия не указана ★ 91 обновлён 2026-10-24
claude mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1Что делает MCP Gateway
MCP Gateway ставится между агентом и его инструментами. Агент видит не полный список из сотен определений, а 9–17 мета-инструментов: gateway_search_tools ищет нужный бэкенд, gateway_invoke его вызывает. Каталог остаётся на стороне шлюза, поэтому в контекст попадают только те инструменты, которые действительно понадобились.
Каждый подключённый MCP-инструмент съедает около 150 токенов контекста на каждый запрос, даже если его не используют. Двадцать серверов со ста инструментами дают примерно 15 000 токенов ещё до начала разговора. Шлюз убирает этот постоянный расход. Но поиск через gateway_search_tools добавляет лишний шаг: бенчмарк в репозитории показал, что на завершённых задачах выигрыша по токенам нет. Экономия не главный аргумент, ценность в другом: вместимость каталога, политики и маршрутизация.
Внутри — Rust-бинарник, без unsafe-кода. За ним можно подключить MCP-серверы по stdio или HTTP и больше 110 REST-возможностей вроде GitHub или Stripe. Для коммерческого запуска нужна отдельная лицензия, личное использование бесплатное.
Какие задачи решает
- подключить больше серверов, чем влезает в контекст
- искать инструменты по запросу, а не держать все определения в памяти
- маршрутизировать вызовы между MCP и REST-бэкендами
- сократить постоянный контекстный расход на неиспользуемые инструменты
Примеры запросов агенту
- Найди инструмент для поиска в документации через
gateway_search_toolsи вызови его черезgateway_invoke. - Подключи все мои MCP-серверы за MCP Gateway и покажи, какие инструменты доступны.
- Проверь здоровье шлюза: запусти
mcp-gateway doctorи скажи, что не так.
Как установить MCP Gateway
Командой платформы
claude mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1Командой платформы
codex mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1Файл настроек
{
"mcpServers": {
"mcp-gateway": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mikkoparkkola/mcp-gateway:3.5.1"
]
}
}
}Файл настроек
{
"servers": {
"mcp-gateway": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mikkoparkkola/mcp-gateway:3.5.1"
]
}
}
}Командой платформы
gemini mcp add mcp-gateway docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCP Gateway
Как установить MCP Gateway в Claude Code?
Выполните claude mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1. После этого агент сможет обращаться к шлюзу.
Что делает MCP Gateway?
Прячет все подключённые MCP-серверы и REST-API за одним компактным набором из 9–17 мета-инструментов. Агент ищет нужный инструмент через gateway_search_tools и вызывает его через gateway_invoke.
В чём разница между обычным подключением серверов и шлюзом?
Без шлюза агент грузит определения всех инструментов в каждый запрос, даже неиспользуемых. Со шлюзом грузится только мета-поверхность, а бэкенды вызываются по требованию. Лишний шаг поиска может стоить токенов на завершённых задачах.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — MCP Gateway от других авторов.