ContextForge

MCP 와 A2A, REST 를 한 주소로 묶는 IBM 게이트웨이

pip install mcp-contextforge-gateway

여러 MCP 서버와 에이전트, REST 나 gRPC API 를 하나의 주소 뒤로 모읍니다. 도구 게이트웨이가 규격 변환과 압축을 맡고, 에이전트 게이트웨이가 에이전트 사이 통신과 라우팅을 담당하고, API 게이트웨이가 속도 제한과 인증, 재시도를 처리합니다. 기존 API 를 MCP 규격 도구로 감싸는 가상화 기능이 있어 오래된 서비스도 붙습니다. gRPC 는 반사 정보를 읽어 자동으로 발견합니다. 플러그인이 40개 넘게 있어 전송 방식과 프로토콜을 더할 수 있습니다. 관측은 오픈텔레메트리로 나가고 여러 추적 백엔드를 지원합니다. PyPI 와 도커로 배포되고 쿠버네티스에서 여러 클러스터로 확장됩니다.

판단

이럴 때 씁니다

  • MCP 서버가 여러 개로 늘어 관리가 안 될 때
  • 기존 REST 나 gRPC API 를 MCP 도구로 감싸야 할 때
  • 도구 호출에 통제와 관측이 필요할 때

이럴 땐 쓰지 마세요

  • MCP 서버가 하나뿐이면 계층만 늘어납니다
  • 비밀키가 없으면 아예 뜨지 않습니다
  • 구성 요소가 많아 운영 부담이 있습니다

차별점

  • MCP 와 에이전트 통신, REST, gRPC 를 한 주소로 묶습니다.
  • 기존 API 를 MCP 규격 도구로 가상화합니다.
  • gRPC 는 반사 정보를 읽어 자동으로 찾아냅니다.
  • 관측이 표준 규격으로 나가 여러 추적 백엔드에 붙습니다.

워크플로

  1. 01비밀키를 생성합니다.
  2. 02게이트웨이를 띄웁니다.
  3. 03MCP 서버와 API 를 등록합니다.
  4. 04가상화로 기존 API 를 도구로 감쌉니다.
  5. 05관측 백엔드를 연결해 호출을 추적합니다.

주요 명령

명령설명
pip install mcp-contextforge-gateway설치합니다.
python3 -m mcpgateway.scripts.init_secrets필수 비밀키를 만듭니다. 이것 없이는 시작되지 않습니다.

함정

설치 전에 확인하세요

  • 인증 비밀키 두 개가 모든 환경에서 필수입니다. 지역 개발에서도 없으면 시작되지 않습니다.
  • 구성 요소가 도구와 에이전트, API 세 갈래로 나뉩니다. 어느 계층을 쓰는지 먼저 정해야 합니다.
  • 플러그인이 40개 넘습니다. 필요한 것만 켜지 않으면 표면이 넓어집니다.
  • 폐기 예정 경로가 따로 문서화되어 있습니다. 판을 올릴 때 확인해야 합니다.

비교

MCP 게이트웨이는 보통 MCP 서버만 묶습니다. 이쪽은 에이전트 통신 규격과 기존 REST, gRPC 까지 같은 등록부에 넣는다는 점이 다릅니다. 대신 그만큼 구성 요소가 많고 운영 부담이 큽니다.

최근 변경

41개 변경을 모은 판입니다. 들어오는 연결에 상호 인증서 인증이 붙고, MCP 서버 인증 흐름이 개선됐으며, 인증 토큰 저장소를 갈아 끼울 수 있게 됐습니다. 도구 미리보기와 스키마 게시 기능도 들어갔습니다.

공식 변경 내역