MCP Routing Gateway

MCP Routing Gateway — это маршрутизатор без сохранения состояния и чистый прокси, разработанный для решения проблемы «выбора LLM инструментов, не предназначенных для пользователя», что является распространенной проблемой, с которой сталкиваются современные популярные ИИ-агенты (например, Claude Desktop, Cline).

🌟 Зачем нужен MCP Routing Gateway?

Когда несколько MCP-серверов регистрируются напрямую в стандартном ИИ-агенте, LLM может свободно просматривать и выполнять все инструменты, что создает риск запуска непредвиденных деструктивных операций или ненужных вызовов инструментов.

Этот проект располагается между ИИ-агентом и фактической группой MCP-серверов, выступая посредником в коммуникации и обеспечивая уровень контроля, который «представляет LLM только безопасно курируемые (отфильтрованные и виртуализированные) инструменты».

🏗️ Архитектура

Этот проект включает в себя функциональные возможности как «MCP-сервера», так и «MCP-клиента».

AI Agent (MCP Client) → | [MCP Server] Gateway [MCP Client] | → Backend MCP Servers

1. Frontend (MCP-сервер): Выступает в качестве «единого безопасного MCP-сервера» для ИИ-агента, принимая соединения через стандартный ввод/вывод (stdio).

2. Backend (MCP-клиент): Считывает mcp_config.json и автоматически запускает и управляет несколькими MCP-серверами, определенными в нем (через порожденные процессы stdio).

🎯 Философия дизайна

Этот проект построен на строгой философии быть «маршрутизатором и чистым прокси».

1. Нулевое вмешательство в полезную нагрузку (сквозная передача): Он не вмешивается в полезные данные, такие как идентификаторы запросов или аргументы. Он полностью сосредоточен на ретрансляции коммуникации, функционируя как чистый канал.

2. Шаблон «Фасад» (фильтрация и переопределение инструментов): Шлюз вмешивается только в маршрутизацию tools/list (представление списка инструментов) и tools/call (вызов инструмента). На основе файла конфигурации он скрывает опасные инструменты или заменяет их безопасными виртуальными инструментами.

⚙️ Конфигурация

Все конфигурации полностью управляются в формате JSON. По умолчанию шлюз ищет эти файлы в рабочем каталоге ~/.mcp-gateway. Вы можете изменить этот каталог с помощью параметра командной строки --work-dir.

1. mcp_config.json (Определение бэкенда): Стандартный формат файла конфигурации для MCP-клиентов. Он определяет группу MCP-серверов, к которым подключается шлюз и которые запускает в фоновом режиме.

2. gateway_config.json (Определение маршрутизации и фильтрации): Файл конфигурации правил, уникальный для шлюза. Он определяет, «какие инструменты скрыть (заблокированные инструменты)» и «какие инструменты виртуализировать (виртуальные инструменты)».

Для получения подробной информации об использовании и параметрах командной строки, пожалуйста, обратитесь к Руководству пользователя.