LLM 애플리케이션을 도구, 데이터, 프롬프트에 연결하는 Model Context Protocol 서버와 클라이언트를 구축하기 위한 공식 Python SDK입니다.
tbxark/mcp-proxy
Claude 같은 클라이언트가 여러 MCP 서버를 단일 HTTP 엔드포인트로 이용할 수 있게 집계하는 MCP 프록시 서버입니다.
- 스타
- 739
- 포크
- 111
- 열린 이슈
- 25
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
MCP Proxy Server는 MCP 클라이언트와 여러 다운스트림 MCP 서버 사이에서 동작하며, 각 서버의 도구, 프롬프트, 리소스를 하나의 HTTP 서버를 통해 제공합니다. 클라이언트는 MCP 서버마다 따로 설정하는 대신 한 번만 연결하면 됩니다.
다운스트림 서버는 로컬 stdio 프로세스로 실행하거나 SSE 또는 streamable HTTP로 연결할 수 있어, 하나의 설정 파일에서 로컬 서버와 원격 서버를 함께 구성할 수 있습니다. 서버 엔드포인트는 Server-Sent Events 또는 streamable HTTP를 사용합니다. Notion처럼 대화형 OAuth 로그인이 필요한 다운스트림 서버의 경우, 프록시가 토큰을 보관하고 갱신해 모든 호출자가 하나의 인증을 공유하도록 할 수 있습니다.
이 프로젝트는 Go로 작성되었으며, 바이너리, Go install 대상, 그리고 npm 및 Python 기반 서버를 실행하는 npx와 uvx가 포함된 Docker 이미지로 제공됩니다. 시작할 때 원격 설정 URL을 전달할 수도 있습니다.
핵심 기능
- 01여러 MCP 서버의 도구, 프롬프트, 리소스를 집계합니다.
- 02Server-Sent Events 또는 streamable HTTP를 통해 클라이언트에 서비스를 제공합니다.
- 03stdio, SSE 또는 streamable HTTP로 다운스트림 서버에 연결합니다.
- 04대화형 로그인이 필요한 다운스트림 서버의 OAuth 토큰을 보관하고 갱신합니다.
- 05바이너리, Go install 또는 Docker 이미지로 제공됩니다.
활용 사례
- Claude 같은 MCP 클라이언트가 여러 로컬 및 원격 MCP 서버에 단일 엔드포인트로 연결하도록 합니다.
- 호스팅된 MCP 서비스의 OAuth 인증 하나를 팀 전체가 공유하도록 합니다.
- npx 또는 uvx로 실행하는 MCP 서버를 컨테이너에서 구동하고 포트 하나를 노출합니다.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/tbxark/mcp-proxy.git - 2
프로젝트 디렉터리로 이동합니다
cd mcp-proxy - 3
바이너리를 빌드합니다
make build - 4
설정 파일을 지정해 프록시를 실행합니다
./build/mcp-proxy --config path/to/config.json
사용 전 알아둘 점
- 프록시를 유용하게 사용하려면 먼저 다운스트림 MCP 서버를 나열한 설정 파일을 작성해야 합니다.
토픽
자주 묻는 질문
- mcp-proxy은(는) 무엇인가요?
- Claude 같은 클라이언트가 여러 MCP 서버를 단일 HTTP 엔드포인트로 이용할 수 있게 집계하는 MCP 프록시 서버입니다. MCP Proxy Server는 MCP 클라이언트와 여러 다운스트림 MCP 서버 사이에서 동작하며, 각 서버의 도구, 프롬프트, 리소스를 하나의 HTTP 서버를 통해 제공합니다. 클라이언트는 MCP 서버마다 따로 설정하는 대신 한 번만 연결하면 됩니다.
- mcp-proxy은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- mcp-proxy은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- mcp-proxy은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. mcp-proxy의 마지막 커밋은 2026년 9월 15일입니다.
- mcp-proxy은(는) 어디에 사용할 수 있나요?
- Claude 같은 MCP 클라이언트가 여러 로컬 및 원격 MCP 서버에 단일 엔드포인트로 연결하도록 합니다. 호스팅된 MCP 서비스의 OAuth 인증 하나를 팀 전체가 공유하도록 합니다. npx 또는 uvx로 실행하는 MCP 서버를 컨테이너에서 구동하고 포트 하나를 노출합니다.
- mcp-proxy는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/tbxark/mcp-proxy.git 프로젝트 디렉터리로 이동합니다: cd mcp-proxy 바이너리를 빌드합니다: make build 설정 파일을 지정해 프록시를 실행합니다: ./build/mcp-proxy --config path/to/config.json
- mcp-proxy은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tbxark/mcp-proxy
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LLM 애플리케이션에 표준화된 컨텍스트를 제공하는 Model Context Protocol 서버와 클라이언트를 구축하기 위한 공식 TypeScript SDK입니다.
MCP 도구, 프롬프트, 설정을 이식 가능한 플레이북으로 묶어 AI 에이전트가 단일 엔드포인트로 연결할 수 있게 하는 로컬 우선 게이트웨이입니다.
Google Search Console 데이터를 Claude, Cursor, Codex 같은 AI assistant에 연결해 자연어로 SEO를 분석하는 MCP 서버입니다.
주요 LLM 제공업체와 연결하고 로컬 지식 베이스를 갖춘 MCP 클라이언트 데스크톱 AI 어시스턴트
MCP 서버, MCP 앱, ChatGPT 앱을 검사하고 채팅하며 디버깅할 수 있는 오픈소스 테스트·평가 플랫폼입니다.