MCP Gateway - это инструмент агрегации серверов, который соединяет несколько серверов протокола контекста модели (MCP) в один шлюз, выставляя все инструменты из подключенных серверов через унифицированный поиск, описание и вызов интерфейсов, и он предоставляет только 5 инструментов.

##Проблема контекстного ограничения

При подключении клиента (Claude Code, Opencode и т.д.) к нескольким MCP-серверам каждый сервер перечисляет все свои инструменты. С 10+ MCP, каждый из которых содержит 10-50 инструментов, вы можете легко превысить 500+ описаний инструментов в системе.

Это создает две проблемы:

1. Контекстный перелив: Многие LLM достигают предела контекста до того, как происходит разговор.
2. Когнитивная перегрузка: LLM изо всех сил пытаются выбрать правильный инструмент из сотен вариантов

Решения для шлюзов

MCP Gateway решает эту проблему, предоставляя поиск инструментов вместо того, чтобы сбрасывать все схемы инструментов:

Как это работает

MCP Gateway работает как MCP-клиент (подключение к вышестоящим серверам), так и MCP-сервер (обнаружение инструментов для нижестоящих клиентов):

1. шлюз запускается и читает конфигурацию 2 Для каждого настроенного вышестоящего сервера Gateway подключается через stdio (локальный) или HTTP/WebSocket (удаленный)
2. Gateway извлекает каталог инструментов с каждого сервера

MCP Gateway

MCP Gateway is a server aggregation tool that connects multiple Model Context Protocol (MCP) servers into a single gateway, exposing all tools from connected servers through unified search, describe, and invoke interfaces and it exposes only 5 tools.

The Context Limit Problem

When connecting an client (Claude Code, Opencode, etc.) to multiple MCP servers, each server lists all its tools. With 10+ MCPs each exposing 10-50 tools, you can easily exceed 500+ tool descriptions in the system prompt:

10 servers × 20 tools each = 200+ tool descriptions
Each tool: 200-500 chars → 40KB-100KB of description just for tool schemas!

This creates two problems:

1. Context overflow: Many LLMs hit their context limit before any conversation happens
2. Cognitive overload: LLMs struggle to choose the right tool from hundreds of options

The Gateway Solution

MCP Gateway solves this by providing tool search instead of dumping all tool schemas:

┌─────────────┐    gateway.search    ┌─────────────────┐    kubernetes::pods_list    ┌──────────────────┐
│  AI Client  │ ───────────────────► │   MCP Gateway   │ ─────────────────────────►  │  Kubernetes MCP  │
│             │                      │                 │                             │                  │
│             │ ◄────────────────────│                 │ ◄─────────────────────────  │                  │
└─────────────┘   pods_list schema   └─────────────────┘         pods output         └──────────────────┘

How It Works

MCP Gateway operates as both an MCP client (connecting to upstream servers) and an MCP server (exposing tools to downstream clients):

┌──────────────┐      MCP       ┌─────────────────┐      MCP       ┌──────────────────┐
│  AI Client   │ ◄────────────  │   MCP Gateway   │ ◄────────────  │  Upstream Server │
│ (Claude, etc)│                │  (this gateway) │                │  (playwright,    │
└──────────────┘                └─────────────────┘                │   kubernetes...) │
                                                                   └──────────────────┘

1. Gateway starts and reads configuration
2. For each configured upstream server, Gateway connects via stdio (local) or HTTP/WebSocket (remote)
3. Gateway fetches the tool catalog from each server
4. All tools are indexed in a unified catalog with search capabilities
5. AI clients connect to Gateway and use gateway.search to find relevant tools
6. Only the tools the client actually needs are invoked