IBM/mcp-context-forge

ContextForge – AI 도구, 에이전트, API의 통합 게이트웨이

무엇인가요 – ContextForge는 오픈소스의 레지스트리 및 프록시로, 어떤 Model Context Protocol (MCP) 서버, A2A(에이전트 간) 서비스, 또는 일반적인 REST/gRPC API를 단일한 중앙 관리형 엔드포인트를 통해 노출할 수 있게 해줍니다. 이는 게이트웨이로서 백엔드를 번역, 탐지, 모니터링하며, LLM 기반 애플리케이션에서 네이티브 MCP 도구처럼 보이게 만듭니다.

왜 중요한가요 – 현대의 LLM 앱은 검색, 데이터베이스, 커스텀 도구, 다른 에이전트 등 여러 외부 서비스를 호출해야 하는 경우가 많습니다. 각 통합을 별도로 관리하면 빠르게 유지보수의 난관에 빠집니다: 인증, 레이트 제한, 재시도, 관측성, 버전 관리 등 모든 서비스마다 별도로 처리해야 하죠. ContextForge는 다음을 통해 이 문제를 해결합니다.

• 이질적인 백엔드(MCP, REST, gRPC)를 하나의 일관된 API 표면으로 통합.
• 중앙 관리 (인증, 레이트 제한, OAuth, JWT, 시크릿 관리) 제공.
• 내장된 관측성을 OpenTelemetry로 제공 (Jaeger, Zipkin, Phoenix 등으로 추적 내보내기).
• 플러그인 확장 (40개 이상)을 통해 추가 전송 방식이나 커스텀 로직 지원.
• 관리자 UI를 제공하여 런타임 설정, 헬스 체크, 로그 탐색 가능.

주요 구성 요소

구성 요소	역할
도구 게이트웨이	MCP, REST, gRPC 서비스를 MCP 호환 도구로 변환; TOON 압축 및 자동 JSON 스키마 추출 지원.
에이전트 게이트웨이	OpenAI 호환, Anthropic, 또는 커스텀 에이전트를 A2A 프로토콜로 라우팅; 토큰 수준 라우팅 및 버전 관리 처리.
API 게이트웨이	일반적인 REST 서비스에 대해 레이트 제한, 재시도, 리버스 프록시 기능 추가.
플러그인 시스템	WebSocket, SSE, stdio 등 추가 전송 방식 및 통합용 40개 이상의 미리 준비된 어댑터 제공.
관측성 레이어	OpenTelemetry 인스트루멘테이션; Phoenix, Jaeger, Zipkin, Tempo, DataDog, New Relic 등으로 내보내기 가능; LLM 전용 메트릭 (토큰 사용량, 비용).
관리자 UI	HTMX/Alpine 기반 대시보드로 서버, 도구, 프롬프트, 리소스 관리 가능; 에어갭 배포도 지원.

실행 방법

• PyPI – pip install mcp-contextforge-gateway 설치 후 mcpgateway CLI로 시작.
• Docker / Docker-Compose – 사전 빌드된 이미지 ghcr.io/ibm/mcp-context-forge 다운로드 후 docker compose up -d로 단일 명령어로 전체 스택 (게이트웨이 + PostgreSQL + Redis + 선택적 Nginx) 실행.
• Kubernetes (Helm) – 멀티클러스터, HA 환경용으로 제공된 Helm 차트 배포; 자동 스케일링, Prometheus 메트릭, 시크릿 주입 포함.
• Dev container – VS Code dev-container 지원으로 빠른 로컬 개발 가능.

일반적인 워크플로우

1. 시크릿 생성 (python -m mcpgateway.scripts.init_secrets).
2. 게이트웨이 시작 (CLI, Docker, 또는 Helm).
3. 관리자 UI 또는 REST 호출로 백엔드 등록 – 예: 레거시 REST 서비스를 http://localhost:4444/gateways에 연결.
4. 도구/프롬프트/리소스 세트를 묶은 가상 서버 생성.
5. 어떤 LLM 클라이언트(OpenAI 호환, Anthropic, 커스텀)에서도 통합 MCP 엔드포인트 사용 – 클라이언트는 하위 구현에 관계없이 단일 /mcp URL을 보게 됩니다.

누가 사용해야 할까

• 여러 이질 서비스를 호출해야 하는 에이전트 기반 AI 애플리케이션을 개발하는 팀.
• 모든 AI 관련 API에 대해 중앙 정책 강제(인증, 레이트 제한, 감사)를 원하는 기업.
• 분산형 LLM 워크로드에서 도구 사용 현황의 관측성을 원하는 개발자.
• 새로운 전송 프로토콜이 등장해도 진화 가능한 플러그인 친화적 게이트웨이가 필요한 사람.

성숙도 및 커뮤니티

• IBM이 지속적으로 유지보수; CI 파이프라인 (테스트, 린팅, 종속성 검토) 보유.
• 7,000개 이상의 자동 테스트와 완전한 CI/CD 워크플로우.
• PyPI 패키지 및 Docker 이미지로 배포; Python 3.11+ 지원.
• 문서 사이트 (ibm.github.io/mcp-context-forge)에는 빠른 시작 가이드, API 참조, 로드맵 포함.
• 기여를 환영합니다 – CONTRIBUTING.md를 참고해 이슈 제출 및 PR 가이드라인 확인.

---

TL;DR – ContextForge는 프로덕션 수준의 확장 가능한 게이트웨이로, 어떤 AI 도구, 에이전트, 서비스(MCP, REST, gRPC)를 하나의 관측 가능하고 중앙 관리되는 엔드포인트로 변환하여 LLM 기반 애플리케이션에서 바로 사용할 수 있게 합니다.