IBM 开源的企业级 AI 网关，统一接入 MCP、A2A 及 REST/gRPC API，提供集中式服务发现、治理护栏与生产级可观测性。
核心能力#
ContextForge 提供六大类能力：
- Tools Gateway：原生 MCP 协议支持，REST/gRPC 自动转换为 MCP（基于反射的服务发现），TOON 压缩优化
- Agent Gateway：A2A (Agent-to-Agent) 协议，OpenAI 兼容与 Anthropic agent 路由
- Model Gateway：LLM 代理，支持 OpenAI API 规范，8+ 模型提供商
- API Gateway：限流、认证、重试、反向代理
- Plugin Extensibility：40+ 插件（传输层、协议、集成）
- Observability：OpenTelemetry 追踪，支持 Phoenix、Jaeger、Zipkin 与其他 OTLP 后端
传输层与协议支持#
- 传输层：HTTP、JSON-RPC、WebSocket、SSE（可配置 keepalive）、stdio、streamable-HTTP
- 协议：MCP（原生）、A2A（Agent-to-Agent）、REST、gRPC（基于反射自动转换）
部署方式#
- PyPI 安装：
pip install mcp-contextforge-gateway - Docker / Docker Compose：支持全栈部署（含 PostgreSQL + Redis + Nginx）
- Kubernetes Helm：支持多云（AWS、Azure、GCP、IBM Cloud、OpenShift），HPA、RBAC、网络策略
快速开始#
# 使用 uv 单命令启动
JWT_SECRET_KEY=my-test-key \
MCPGATEWAY_UI_ENABLED=true \
MCPGATEWAY_ADMIN_API_ENABLED=true \
uvx --from mcp-contextforge-gateway mcpgateway --host 0.0.0.0 --port 4444
Admin UI：http://localhost:4444/admin API 文档：http://localhost:4444/docs（Swagger）、http://localhost:4444/redoc
安全特性#
- 内置认证、重试、限流
- 用户级 OAuth token
- X-Upstream-Authorization 头支持授权透传
REQUIRE_JTI=true（令牌可撤销）、REQUIRE_TOKEN_EXPIRATION=true（强制过期）PUBLIC_REGISTRATION_ENABLED=false（禁止公开注册）
管理与扩展#
- Admin UI：实时管理、配置、日志监控，支持 airgapped 离线部署
- 插件系统：plugins/ 与 plugin_templates/ 目录
- Redis 联邦与缓存支持
技术栈#
- 核心框架：FastAPI（Python）
- 数据层：SQLAlchemy ORM（SQLite / PostgreSQL / MariaDB / MySQL）
- 语言构成：Python (83.9%)、JavaScript (5.6%)、HTML (5.1%)、Makefile (2.0%)、Rust (1.1%)、Go (1.0%)
- 容器镜像：ghcr.io/ibm/mcp-context-forge
核心作者#
Mihai Criveti (Distinguished Engineer, Agentic AI, IBM)
已知限制#
- 当前不支持 ARM64 生产部署