Repolode
tbxark

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. 1

    저장소를 클론합니다

    git clone https://github.com/tbxark/mcp-proxy.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd mcp-proxy
  3. 3

    바이너리를 빌드합니다

    make build
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트