mcp-routing-gateway
An MCP routing proxy that prevents LLMs from executing unintended tools. It securely curates, filters, and routes tools from multiple backend MCP servers. (LLMが意図しないツールを実行するのを防ぐMCPルーティングプロキシ。複数のバックエンドMCPサーバーからのツールを安全にキュレーション、フィルタリング、ルーティングします。)
Ask AI about mcp-routing-gateway
Powered by Claude · Grounded in docs
I know everything about mcp-routing-gateway. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
MCP Routing Gateway
The MCP Routing Gateway is a stateless router and Pure Proxy designed to solve the problem of "LLMs selecting tools unintended by the user," which is a common issue faced by current mainstream AI agents (e.g., Claude Desktop, Cline).
🌟 Why MCP Routing Gateway?
When multiple MCP servers are registered directly to a standard AI agent, the LLM can freely browse and execute all tools, posing the risk of triggering unexpected destructive operations or unnecessary tool calls.
This project sits between the AI agent and the actual group of MCP servers, mediating the communication to provide a control layer that "presents only safely curated (filtered and virtualized) tools to the LLM."
🏗️ Architecture
This project incorporates both "MCP Server" and "MCP Client" functionalities internally.
AI Agent (MCP Client) → | [MCP Server] Gateway [MCP Client] | → Backend MCP Servers
- Frontend (MCP Server): Acts as a "single, secure MCP server" to the AI agent, accepting connections via standard input/output (
stdio). - Backend (MCP Client): Reads
mcp_config.jsonand automatically launches and manages multiple MCP servers defined within it (viastdiospawned processes).
🎯 Design Philosophy
This project is built on the strict philosophy of being a "Router and Pure Proxy."
- Zero Payload Interference (Pass-through): It does not interfere with payloads such as request IDs or arguments. It focuses entirely on relaying communication, functioning as a pure pipe.
- Facade Pattern (Filtering and Tool Overrides):
The Gateway only intervenes in the routing of
tools/list(presenting the tool list) andtools/call(tool invocation). Based on the configuration file, it hides dangerous tools or replaces them with secure virtual tools.
⚙️ Configuration
All configurations are entirely managed in JSON format. By default, the gateway looks for these files in the working directory ~/.mcp-routing-gateway. You can change this directory using the --work-dir CLI option.
mcp_config.json(Backend Definition): The standard configuration file format for MCP clients. It defines the group of MCP servers that the Gateway connects to and launches in the background.gateway_config.json(Routing and Filter Definition): A rule configuration file unique to the Gateway. It defines "which tools to hide (Blocked Tools)" and "which tools to virtualize (Virtual Tools)."
For detailed usage and CLI options, please see the User Manual.