IBM/mcp-context-forge

MCP/REST/gRPC API를 하나의 통합 게이트웨이로 연결하고 관리하는 오픈소스 레지스트리 및 프록시

설치형 도구맘대로 써도 됨 · Apache-2.0데브옵스·인프라Python난이도
3,989+31이번 주0 찜
733포크865이슈
데모·홈페이지 열기ibm.github.io

중간맛 분석

스택: Python 3.11+, FastAPI, asyncio, PostgreSQL/SQLite, Redis, OpenTelemetry 난이도: 중상(federation, 지원) 바로 쓸 수 있나: 예. PyPI(mcp-contextforge-gateway), Compose, Helm으로 즉시 배포 가능 데모: Compose로 30초 안에 PostgreSQL+Redis 풀스택 실행, 또는 PyPI로 단일 명령어 시작 가능

이런 레포예요

이럴 때 쓰면 좋아요

  • 여러 AI 에이전트가 다양한 도구(MCP/REST/gRPC)를 통일된 방식으로 호출해야 할 때
  • 마이크로서비스 기반 AI 인프라에서 중앙 인증·속도 제한·모니터링이 필요할 때
  • 레거시 REST/gRPC API를 MCP 호환 도구로 가상화하여 에이전트에 노출하고 싶을 때

핵심 기능

MCP/A2A/REST/gRPC 프로토콜 자동 통합 및 변환중앙집중식 인증, 속도 제한, 재시도 정책OpenTelemetry 기반 분산 추적(Phoenix/Jaeger/Zipkin 등)

대안 대비 차별점

gRPC-to-MCP 자동 반사 기반 서비스 검색과 TOON 압축을 통해 레거시 시스템을 별도 코드 수정 없이 MCP 생태계에 통합할 수 있습니다.

준비물

  • Python 3.11 이상
  • curl + jq (선택사항, API 테스트용)

바로 시작하기

  1. 파이썬 가상환경 생성 및 PyPI에서 설치
mkdir mcpgateway && cd mcpgateway
python3 -m venv .venv && source .venv/bin/activate
pip install --upgrade pip
pip install mcp-contextforge-gateway
  1. 환경설정 파일 다운로드 및 커스터마이징
curl -O https://raw.githubusercontent.com/IBM/mcp-context-forge/main/.env.example
cp .env.example .env
  1. 환경변수 설정
export MCPGATEWAY_UI_ENABLED=true
export MCPGATEWAY_ADMIN_API_ENABLED=true
export PLATFORM_ADMIN_EMAIL=admin@example.com
export PLATFORM_ADMIN_PASSWORD=changeme
export PLATFORM_ADMIN_FULL_NAME="Platform Administrator"
export JWT_SECRET_KEY=my-test-key-but-now-longer-than-32-bytes
  1. 게이트웨이 실행
BASIC_AUTH_PASSWORD=pass mcpgateway --host 0.0.0.0 --port 4444
  1. JWT 토큰 생성
export MCPGATEWAY_BEARER_TOKEN=$(python3 -m mcpgateway.utils.create_jwt_token \
    --username admin@example.com --exp 10080 --secret my-test-key-but-now-longer-than-32-bytes)
  1. API 동작 확인
curl -s -H "Authorization: Bearer $MCPGATEWAY_BEARER_TOKEN" \
     http://127.0.0.1:4444/version | jq

별 추이 · 7일

3,989+31 / 7일

활용성 · 따라 만들기 좋은가

베스트 샘플샘플 점수 64/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2025년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/IBM/mcp-context-forge.svg)](https://www.gitbap.com/r/IBM/mcp-context-forge)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기