ContextForge

一个开源的注册中心和代理，用于联合 MCP、A2A 和 REST/gRPC API，并提供集中式的治理、发现和可观测性。它优化了 Agent 和 Tool 的调用，并支持插件扩展。

     

     

ContextForge 是一个开源的注册中心和代理，它将工具、Agent 和 API 联合为一个干净的端点，供您的 AI 客户端使用。它为您的 AI 基础设施提供了集中式的治理、发现和可观测性：

• 工具网关 (Tools Gateway) — 支持 MCP、REST、gRPC 转 MCP 翻译以及 TOON 压缩
• Agent 网关 (Agent Gateway) — 支持 A2A 协议、兼容 OpenAI 和 Anthropic 的 Agent 路由
• API 网关 (API Gateway) — 为 REST 服务提供速率限制、身份验证、重试和反向代理功能
• 插件扩展性 (Plugin Extensibility) — 提供 40 多种插件，支持额外的传输方式、协议和集成
• 可观测性 (Observability) — 通过 Phoenix、Jaeger、Zipkin 及其他 OTLP 后端提供 OpenTelemetry 追踪

它作为一个完全兼容的 MCP 服务器运行，可通过 PyPI 或 Docker 部署，并借助 Redis 支持的联邦和缓存功能扩展至 Kubernetes 多集群环境。

---

目录

• 概述与目标
• 快速入门 - PyPI
• 快速入门 - 容器
• VS Code 开发容器
• 安装
• 升级
• 配置
• 运行
• 云部署
• API 参考
• 测试
• 项目结构
• 开发
• 故障排查
• 贡献

---

📌 快速链接

资源	描述
5 分钟设置	快速上手 — uvx, Docker, Compose 或本地开发
获取帮助	支持选项、常见问题解答、社区频道
问题指南	如何提交 Bug、申请功能、贡献代码
完整文档	完整指南、教程、API 参考

---

概述与目标

ContextForge 是一个开源的注册中心和代理，它联合了任何 Model Context Protocol (MCP) 服务器、A2A 服务器或 REST/gRPC API，提供集中式的治理、发现和可观测性。它优化了 Agent 和工具的调用，并支持插件。详见 项目路线图。

目前支持：

• 跨多个 MCP 和 REST 服务的联邦
• A2A (Agent-to-Agent) 集成，用于外部 AI Agent（OpenAI、Anthropic、自定义）
• gRPC 转 MCP 翻译，通过基于反射的自动服务发现实现
• 将遗留 API 虚拟化为符合 MCP 标准的工具和服务器
• 支持通过 HTTP、JSON-RPC、WebSocket、SSE（可配置 keepalive）、stdio 和 streamable-HTTP 进行传输
• 提供用于实时管理、配置和日志监控的 Admin UI（支持气隙环境部署）
• 内置身份验证、重试和速率限制，支持用户级 OAuth 令牌和无条件的 X-Upstream-Authorization 标头
• OpenTelemetry 可观测性，支持 Phoenix、Jaeger、Zipkin 及其他 OTLP 后端
• 通过 Docker 或 PyPI、Redis 缓存及多集群联邦实现可扩展部署