# MCP Gateway

MCP Gateway — MCP-сервер, который прячет каталог инструментов за компактным набором мета-инструментов и вызывает бэкенды по требованию.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 91 у репозитория
- Автор: MikkoParkkola
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/MikkoParkkola/mcp-gateway
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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. Для коммерческого запуска нужна отдельная лицензия, личное использование бесплатное.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1
```

### Codex

**Командой платформы**
```bash
codex mcp add mcp-gateway -- docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-gateway": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/mikkoparkkola/mcp-gateway:3.5.1"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-gateway": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/mikkoparkkola/mcp-gateway:3.5.1"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mcp-gateway docker run -i --rm ghcr.io/mikkoparkkola/mcp-gateway:3.5.1
```

## Когда брать
- подключить больше серверов, чем влезает в контекст
- искать инструменты по запросу, а не держать все определения в памяти
- маршрутизировать вызовы между MCP и REST-бэкендами
- сократить постоянный контекстный расход на неиспользуемые инструменты

## Примеры запросов агенту
- Найди инструмент для поиска в документации через `gateway_search_tools` и вызови его через `gateway_invoke`.
- Подключи все мои MCP-серверы за MCP Gateway и покажи, какие инструменты доступны.
- Проверь здоровье шлюза: запусти `mcp-gateway doctor` и скажи, что не так.

## Похожие
- [Agent MCP Gateway](https://affpapa.org/nevibecode/mcp/agent-mcp-gateway.md) — MCP-сервер · ★ 42 у репозитория
- [mcp-gateway](https://affpapa.org/nevibecode/mcp/rupinder2-mcp-gateway.md) — MCP-сервер · ★ 6 у репозитория
- [gateway-workers](https://affpapa.org/nevibecode/skills/gateway-workers.md) — скилл · 25500 установок
- [gpt2api-openai-gateway](https://affpapa.org/nevibecode/skills/gpt2api-openai-gateway.md) — скилл · 385 установок
- [llm-gateway](https://affpapa.org/nevibecode/skills/llm-gateway.md) — скилл · 370 установок
- [logfire-gateway](https://affpapa.org/nevibecode/skills/logfire-gateway.md) — скилл · 232 установки

## Другие версии с тем же именем
- [MCP Gateway · panossalt](https://affpapa.org/nevibecode/mcp/panossalt-mcp-gateway.md) — ★ 6 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
