MCP Routing Gateway

MCP Routing Gateway는 현재 주류 AI 에이전트(예: Claude Desktop, Cline)가 직면한 공통적인 문제인 "LLM이 사용자가 의도하지 않은 도구를 선택하는 문제"를 해결하기 위해 설계된 상태 비저장(stateless) 라우터이자 순수 프록시입니다.

🌟 왜 MCP Routing Gateway인가요?

여러 MCP 서버가 표준 AI 에이전트에 직접 등록되면, LLM이 모든 도구를 자유롭게 탐색하고 실행할 수 있어 예기치 않은 파괴적 작업이나 불필요한 도구 호출이 발생할 위험이 있습니다.

이 프로젝트는 AI 에이전트와 실제 MCP 서버 그룹 사이에 위치하여 통신을 중재함으로써 **"안전하게 큐레이션(필터링 및 가상화)된 도구만 LLM에 제공"**하는 제어 계층을 제공합니다.

🏗️ 아키텍처

이 프로젝트는 내부적으로 "MCP 서버"와 "MCP 클라이언트" 기능을 모두 포함합니다.

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

프론트엔드 (MCP 서버): AI 에이전트에 대해 "단일 보안 MCP 서버" 역할을 하며, 표준 입출력(stdio)을 통해 연결을 수락합니다.
백엔드 (MCP 클라이언트): mcp_config.json을 읽고 그 안에 정의된 여러 MCP 서버를 자동으로 실행 및 관리합니다(stdio로 생성된 프로세스를 통해).

🎯 설계 철학

이 프로젝트는 **"라우터 및 순수 프록시"**라는 엄격한 철학을 바탕으로 구축되었습니다.

제로 페이로드 간섭 (Pass-through): 요청 ID나 인수와 같은 페이로드를 간섭하지 않습니다. 순수한 파이프처럼 작동하며 통신을 중계하는 데에만 집중합니다.
퍼사드 패턴 (필터링 및 도구 재정의): 게이트웨이는 tools/list(도구 목록 제공) 및 tools/call(도구 호출)의 라우팅에만 개입합니다. 구성 파일을 기반으로 위험한 도구를 숨기거나 안전한 가상 도구로 대체합니다.

⚙️ 구성

모든 구성은 JSON 형식으로 완전히 관리됩니다. 기본적으로 게이트웨이는 작업 디렉토리 ~/.mcp-gateway에서 이러한 파일을 찾습니다. --work-dir CLI 옵션을 사용하여 이 디렉토리를 변경할 수 있습니다.

mcp_config.json (백엔드 정의): MCP 클라이언트를 위한 표준 구성 파일 형식입니다. 게이트웨이가 연결하고 백그라운드에서 실행할 MCP 서버 그룹을 정의합니다.
gateway_config.json (라우팅 및 필터 정의): 게이트웨이 고유의 규칙 구성 파일입니다. "어떤 도구를 숨길지(차단된 도구)"와 "어떤 도구를 가상화할지(가상 도구)"를 정의합니다.

자세한 사용법 및 CLI 옵션은 사용자 매뉴얼을 참조하십시오.