mcp-gateway — MCP-сервер для Claude Code: что делает и как установить
Объединяет несколько downstream MCP-серверов в единую точку входа. Позволяет искать инструменты через BM25 или regex и подгружать их по требованию без переполнения контекста.
claude mcp add --env STORAGE_BACKEND=<STORAGE_BACKEND> --env REDIS_URL=<REDIS_URL> --env SERVER_CONFIG_PATH=<SERVER_CONFIG_PATH> --transport stdio rupinder2-mcp-gateway -- uvx mcp-orchestration-gatewayЧто делает mcp-gateway
Шлюз агрегирует вызовы к сторонним MCP-серверам, работающим по протоколам stdio или HTTP. Вместо загрузки десятков определений функций сразу в контекст модели он отдаёт агенту вспомогательные утилиты tool_search, discover_tools и call_remote_tool. Поиск умеет ранжировать совпадения через BM25 либо фильтровать регулярными выражениями.
Имена инструментов получают префикс server_name__tool_name, чтобы исключить коллизии между разными серверами. Список внешних узлов и параметры авторизации задаются в файле server_config.json. Для кеширования схем по умолчанию используется оперативная память, но для долговременного хранения поддерживается Redis через переменную REDIS_URL. Без корректного пути к конфигурации в SERVER_CONFIG_PATH шлюз запустится пустым.
Запуск возможен через команду uvx mcp-orchestration-gateway либо напрямую через Python. Сервер умеет работать как локальный процесс stdio или как отдельный HTTP-сервис с портом и поддержкой CORS.
Какие задачи решает
- Объединить разрозненные MCP-серверы в единый узел
- Искать нужные инструменты по описанию без перегрузки контекстного окна
- Маршрутизировать вызовы функций с префиксом источника
- Подключать внешние инструменты по протоколам stdio и HTTP
Примеры запросов агенту
- Найди через
tool_searchинструменты, подходящие для проверки прогноза погоды. - Загрузи список доступных функций с сервера
docs-serverс помощьюdiscover_tools. - Выполни вызов
api-server__fetch_dataс помощьюcall_remote_tool, указав параметры запроса.
Как установить mcp-gateway
Командой платформы
claude mcp add --env STORAGE_BACKEND=<STORAGE_BACKEND> --env REDIS_URL=<REDIS_URL> --env SERVER_CONFIG_PATH=<SERVER_CONFIG_PATH> --transport stdio rupinder2-mcp-gateway -- uvx mcp-orchestration-gatewayВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-orchestration-gateway <команда>
Командой платформы
codex mcp add rupinder2-mcp-gateway --env STORAGE_BACKEND=<STORAGE_BACKEND> --env REDIS_URL=<REDIS_URL> --env SERVER_CONFIG_PATH=<SERVER_CONFIG_PATH> -- uvx mcp-orchestration-gatewayВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-orchestration-gateway <команда>
Файл настроек
{
"mcpServers": {
"rupinder2-mcp-gateway": {
"command": "uvx",
"args": [
"mcp-orchestration-gateway"
],
"env": {
"STORAGE_BACKEND": "<STORAGE_BACKEND>",
"REDIS_URL": "<REDIS_URL>",
"SERVER_CONFIG_PATH": "<SERVER_CONFIG_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-orchestration-gateway <команда>
Файл настроек
{
"servers": {
"rupinder2-mcp-gateway": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-orchestration-gateway"
],
"env": {
"STORAGE_BACKEND": "<STORAGE_BACKEND>",
"REDIS_URL": "<REDIS_URL>",
"SERVER_CONFIG_PATH": "<SERVER_CONFIG_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-orchestration-gateway <команда>
Командой платформы
gemini mcp add -e STORAGE_BACKEND=<STORAGE_BACKEND> -e REDIS_URL=<REDIS_URL> -e SERVER_CONFIG_PATH=<SERVER_CONFIG_PATH> rupinder2-mcp-gateway uvx mcp-orchestration-gatewayВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-orchestration-gateway <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-gateway
Как установить mcp-gateway в Claude Code?
Выполните команду claude mcp add mcp-gateway -- uvx mcp-orchestration-gateway. Если нужно передать переменные окружения, используйте `claude mcp add --env STORAGE_BACKEND=<STORAGE_BACKEND> --env REDIS_URL=<REDIS_URL> --env SERVER_CONFIG_PATH=<SERVER_CONFIG_PATH> --transport stdio rupinder2-mcp-gateway -- uvx mcp-orchestration-gateway`.
Что делает mcp-gateway?
Шлюз агрегирует функции из нескольких downstream MCP-серверов и предоставляет к ним доступ через инструменты поиска и отложенного вызова. Это предотвращает переполнение контекста большими схемами.
Как mcp-gateway хранит данные и кеш инструментов?
По умолчанию используется хранилище в оперативной памяти (memory). Для сохранения схем можно подключить Redis, задав STORAGE_BACKEND=redis и адрес в переменной REDIS_URL.
