supercorp-ai/supergateway

해결하는 문제

Supergateway는 Model Context Protocol (MCP)에서 사용되는 다양한 통신 프로토콜 간의 간극을 연결하는 방법을 제공합니다. 구체적으로, Server-Sent Events (SSE), WebSockets (WS) 및 Streamable HTTP와 같은 웹 기반 프로토콜을 통해 표준 입력/출력(stdio)만 지원하는 MCP 서버를 실행할 수 있게 하여, 원격 액세스, 더 쉬운 디버깅, 그리고 stdio를 지원하지 않는 클라이언트와의 통합을 가능하게 합니다.

작동 방식

전송 계층 변환기 역할을 합니다. 구성에 따라 다음과 같은 변환을 수행할 수 있습니다.

• stdio $\to$ SSE/WS/Streamable HTTP: 로컬 MCP stdio 서버를 네트워크 서비스로 노출합니다.
• SSE/Streamable HTTP $\to$ stdio: 원격 MCP 서버에 연결하여 로컬에서 stdio 서버로 노출합니다. 이는 원격 서버를 로컬 CLI 환경이나 Claude Desktop 및 Cursor 같은 AI 어시스턴트에 통합하는 데 유용합니다.

대상 사용자

자신의 도구를 원격 클라이언트에 노출해야 하거나, 웹 기반 도구(MCP Inspector 등)를 사용하여 서버를 디버깅하거나, 원격 MCP 서버를 로컬 AI 에이전트에 통합하려는 MCP 서버를 구축하거나 사용하는 개발자.

주요 기능

• 다중 프로토콜 지원: SSE, WebSockets, Streamable HTTP(스테이트리스 및 스테이트풀)를 지원합니다.
• 유연한 배포: npx, Docker 또는 로컬 설치를 통해 실행할 수 있습니다.
• 인증 지원: 안전한 원격 연결을 위한 사용자 정의 헤더 및 OAuth2 Bearer 토큰 추가를 위한 플래그가 포함되어 있습니다.
• 통합 준비 완료: Claude Desktop 및 Cursor와 함께 쉽게 사용할 수 있도록 특별히 구성되었습니다.
• CORS 및 헬스 체크: CORS 활성화 및 헬스 체크 엔드포인트 등록에 대한 기본 지원이 포함되어 있습니다.