ghcr.io/ibm/mcp-context-forge:amd64-71221d3d66ecd76e54df90a8175d8ab2f26c0734

ContextForge

一个开源注册中心和代理，用于整合MCP、A2A及REST/gRPC API，提供集中治理、发现和可观测性。优化智能体（Agent）与工具调用，并支持插件扩展。

ContextForge 是一个开源注册中心和代理，它将工具、智能体和API整合到一个简洁的端点，供您的AI客户端使用。它在整个AI基础设施中提供集中治理、发现和可观测性：

• 工具网关（Tools Gateway） — MCP、REST、gRPC到MCP的转换，以及TOON压缩
• 智能体网关（Agent Gateway） — A2A协议、OpenAI兼容和Anthropic智能体路由
• API网关（API Gateway） — REST服务的速率限制、认证、重试和反向代理
• 插件可扩展性（Plugin Extensibility） — 40+插件，支持额外的传输方式、协议和集成
• 可观测性（Observability） — 支持Phoenix、Jaeger、Zipkin及其他OTLP后端的OpenTelemetry追踪

它作为完全合规的MCP服务器运行，可通过PyPI或Docker部署，并能借助Redis支持的整合与缓存，扩展到Kubernetes上的多集群环境。

Windows (PowerShell) 快速入门

# 1️⃣ 隔离环境 + 从 PyPI 安装
mkdir mcpgateway ; cd mcpgateway
python3 -m venv .venv ; .\.venv\Scripts\Activate.ps1
pip install --upgrade pip
pip install mcp-contextforge-gateway

# 2️⃣ 复制并自定义配置
# 下载示例环境文件
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/IBM/mcp-context-forge/main/.env.example" -OutFile ".env.example"
Copy-Item .env.example .env
# 编辑 .env 以自定义设置

# 或设置环境变量（仅当前会话有效）
$Env:MCPGATEWAY_UI_ENABLED = "true"
$Env:MCPGATEWAY_ADMIN_API_ENABLED = "true"
> [!NOTE] API 的基本身份验证默认禁用（API_ALLOW_BASIC_AUTH=false）
$Env:JWT_SECRET_KEY = "my-test-key-but-now-longer-than-32-bytes"
$Env:PLATFORM_ADMIN_EMAIL = "admin@example.com"
$Env:PLATFORM_ADMIN_PASSWORD = "changeme"
$Env:PLATFORM_ADMIN_FULL_NAME = "Platform Administrator"

# 3️⃣ 启动网关
mcpgateway.exe --host 0.0.0.0 --port 4444

# 可选：在后台运行
# Start-Process -FilePath "mcpgateway.exe" -ArgumentList "--host 0.0.0.0 --port 4444"

# 4️⃣ 获取 Bearer 令牌并进行 API 冒烟测试
$Env: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

curl -s -H "Authorization: Bearer $Env:MCPGATEWAY_BEARER_TOKEN" `
http://127.0.0.1:4444/version | jq

启用HTTPS（可选）：

# 启用TLS启动（自动生成自签名证书）
make compose-tls

# 通过HTTPS访问：https://localhost:8443/admin

# 或者使用您自己的证书：
# 未加密密钥：
mkdir -p certs
cp your-cert.pem certs/cert.pem && cp your-key.pem certs/key.pem
make compose-tls

# 带密码保护的密钥：
mkdir -p certs
cp your-cert.pem certs/cert.pem && cp your-encrypted-key.pem certs/key-encrypted.pem
echo "KEY_FILE_PASSWORD=your-passphrase"
>> .env
make compose-tls

升级

有关升级说明、迁移指南和回滚流程，请参见：

• https://ibm.github.io/mcp-context-forge/manage/upgrade/ — 通用升级流程
• CHANGELOG.md — 版本历史和破坏性变更

运行

快速参考

开发服务器（Uvicorn）

make dev # Uvicorn运行在:8000，带自动重载和SQLite
# 或
./run.sh --reload --log debug --workers 2

run.sh 是 uvicorn 的包装器，用于加载 .env、支持自动重载，并将参数传递给服务器。

主要标志：

生产服务器（Gunicorn）

make serve # Gunicorn运行在:4444，带多个工作进程
make serve-ssl # Gunicorn运行在:4444并启用HTTPS（使用./certs）

Docker Compose（完整栈）

make compose-up # 启动完整栈：PostgreSQL、Redis、3个网关副本、Nginx（端口8080）
make compose-sso # 启动带Keycloak的SSO栈（端口8180）
make sso-test-login # 运行SSO冒烟测试（提供程序+登录URL+测试用户）
make compose-logs # 跟踪所有服务的日志
make compose-down # 停止栈

手动运行（Uvicorn）

uvicorn mcpgateway.main:app --host 0.0.0.0 --port 4444 --workers 4

有关详细的故障排除指南，请参阅 **https://ibm.github.io/mcp-context-forge/manage/troubleshooting/**%E3%80%82

---

贡献指南

1. Fork 仓库，创建功能分支。
2. 运行 make lint 并修复所有问题。
3. 确保 make test 测试通过。
4. 提交包含已签名提交的 PR（git commit -s）。

有关完整指南，请参阅 CONTRIBUTING.md；有关如何提交错误报告、请求功能以及查找可参与的问题，请参阅 **https://github.com/IBM/mcp-context-forge/issues/2502**%E3%80%82

---

变更日志

完整的变更日志可在此处查看：CHANGELOG.md

许可协议

根据 Apache License 2.0 许可 - 详见 LICENSE

核心作者与维护者

• Mihai Criveti - 杰出工程师，智能体 AI（Agentic AI）

特别感谢所有贡献者帮助我们改进 ContextForge：

星级历史和项目活动