ContextForge: AI Gateway Cho MCP, A2A Và REST API
/mcp-context-forge
ContextForge là registry và proxy mã nguồn mở của IBM, hợp nhất các MCP server, A2A agent, và REST/gRPC API đằng sau một gateway endpoint duy nhất. Hãy dùng nó nếu bạn đã chạy nhiều MCP server và muốn có một điểm vào xác thực tập trung với auth, discovery, và tracing thay vì tự cài đặt riêng cho từng client; bỏ qua nếu bạn chỉ chạy một MCP server, vì việc tạo secret bắt buộc và stack chạy trên Postgres tốn công sức hơn mức cần cho quy mô đó.
ContextForge Làm Gì
ContextForge là registry và proxy mã nguồn mở của IBM, hợp nhất các MCP server, A2A agent, và REST/gRPC API đằng sau một endpoint duy nhất cho AI client. Nó chạy như một MCP server tuân thủ đầy đủ chuẩn, dịch REST và gRPC service thành tool, prompt, và resource kiểu MCP, kèm một Admin UI để quản lý những gì đã đăng ký. Nó triển khai qua PyPI, Docker, hay Helm chart cho Kubernetes, với caching qua Redis cho các thiết lập multi-cluster.
Năng Lực Cốt Lõi Của Gateway
- ✓Tools Gateway dịch các REST và gRPC service thành tool tuân thủ MCP, bao gồm gRPC-to-MCP translation qua reflection-based service discovery tự động, theo README.
- ✓Agent Gateway định tuyến traffic giao thức A2A (Agent-to-Agent) và hỗ trợ định tuyến agent tương thích OpenAI lẫn Anthropic.
- ✓Lớp API Gateway thêm rate limiting, authentication, retry, và reverse proxy phía trước các REST service thuần.
- ✓Registry hợp nhất cho prompt (template Jinja2 với rollback/versioning), resource (truy cập theo URI với nhận diện MIME và cập nhật SSE), và tool (có input validation và kiểm soát concurrency).
- ✓Tracing OpenTelemetry đi kèm sẵn hỗ trợ Phoenix, Jaeger, Zipkin, Tempo, DataDog, và New Relic làm backend, cộng thêm các metric riêng cho LLM như token usage và chi phí, và README nói nó không tốn thêm overhead khi tắt.
- ✓Linh hoạt về transport: hỗ trợ HTTP, JSON-RPC, WebSocket, SSE với keepalive tuỳ chỉnh, stdio, và streamable-HTTP, và bạn có thể chọn phiên bản MCP protocol (ví dụ 2025-11-25) cho từng kết nối.
- ✓Hơn 40 plugin mở rộng transport, protocol, và tích hợp, theo README.
- ✓Admin UI (xây trên HTMX 2.0.3 và Alpine.js) cung cấp log viewer thời gian thực với filter, search, và export, cùng hỗ trợ triển khai airgapped.
Quản Lý AI Agent Và Tool
- •Đăng ký một MCP server có sẵn (hoặc một REST/gRPC service được bọc qua mcpgateway.translate) với endpoint /gateways của gateway, để mọi AI client chỉ cần gọi một URL đã xác thực thay vì kết nối trực tiếp tới từng server.
- •Gộp nhiều tool đã đăng ký thành một 'virtual server' qua endpoint /servers, để một agent có một endpoint MCP duy nhất đứng trước nhiều nguồn tool khác nhau.
- •Định tuyến traffic A2A tới agent tương thích OpenAI hoặc Anthropic qua cùng một gateway, theo năng lực Agent Gateway của README, thay vì duy trì logic kết nối riêng cho từng agent framework.
- •Bọc một REST API cũ thành tool tuân thủ MCP tự động, với gateway tự trích JSON Schema và xử lý header, token, retry, và rate limit giúp bạn.
- •Trace các lời gọi tool và prompt xuyên suốt các gateway đã liên kết bằng OpenTelemetry, chuyển tiếp tới Phoenix, Jaeger, Zipkin, hay backend OTLP khác để xem một chuỗi gọi multi-agent thực sự tốn thời gian ở đâu.
Cài Đặt Và Triển Khai
ContextForge được publish trên PyPI với tên mcp-contextforge-gateway, nên `pip install mcp-contextforge-gateway` (hoặc cách nhanh hơn `uvx --from mcp-contextforge-gateway mcpgateway`) là đủ để lấy package; yêu cầu Python 3.11 trở lên. Trước khi khởi động được, bạn phải tạo secret thật bằng `python3 -m mcpgateway.scripts.init_secrets` — README nói rõ JWT_SECRET_KEY và AUTH_ENCRYPTION_SECRET là bắt buộc ở mọi môi trường, kể cả local, và gateway sẽ không chạy nếu thiếu chúng. Để có full stack với PostgreSQL và Redis, clone repo rồi chạy `docker compose up -d`; lệnh này pull image dựng sẵn từ GHCR thay vì build local, vì build local cần một hermetic wheel closure chỉ được tạo ra bởi CI pipeline. Triển khai Kubernetes đi qua Helm chart trong charts/mcp-stack, với các tính năng enterprise như HPA autoscaling và RBAC. Một lưu ý về nền tảng từ README: arm64 không được hỗ trợ trên production container, nên người dùng Apple Silicon nên chạy qua Rosetta hoặc cài qua PyPI thay thế.
Điểm mạnh
- ✓Thực sự hợp nhất ba thế giới khác nhau — MCP server, A2A agent, và REST/gRPC thuần — đằng sau một endpoint, thay vì chỉ giải quyết một trong số đó.
- ✓Observability không phải thứ gắn thêm cho có: tracing OpenTelemetry bao phủ sáu lựa chọn backend (Phoenix, Jaeger, Zipkin, Tempo, DataDog, New Relic) cùng các metric riêng cho LLM như token usage và chi phí.
- ✓Nhiều đường triển khai tuỳ theo nhu cầu — một lệnh uvx duy nhất để test local, Docker Compose cho full stack Postgres/Redis, và Helm cho Kubernetes với autoscaling.
- ✓Mặc định bảo mật nghiêm ngặt thay vì dễ dãi: secret là bắt buộc kể cả khi chạy local, và SSRF protection của Helm chặn URL mạng nội bộ trừ khi bạn cho phép rõ ràng.
- ✓README nêu hơn 7.000 test cùng pre-commit hook và live reload, một tín hiệu thực về kỷ luật kỹ thuật cho một dự án ở quy mô này.
Lưu Ý Và Hạn Chế Hiện Tại
- △Chạy được một instance local tốn nhiều hơn vài lệnh: bạn phải tạo và export JWT_SECRET_KEY và AUTH_ENCRYPTION_SECRET trước khi gateway chịu khởi động, nhiều công sức cài đặt hơn một tool kiểu pip-install-là-chạy thông thường.
- △Container arm64 không được hỗ trợ trên production, theo README, nên người dùng Apple Silicon bị đẩy sang dùng Rosetta hoặc cài qua PyPI thay vì đường container native.
- △Helm repository chưa được publish — chính hướng dẫn Kubernetes trong README bảo clone repo và dùng local chart trong charts/mcp-stack thay vì một helm repo add thông thường.
- △docker compose build local cũng không phải đường mặc định; README cảnh báo build local từ đầu cần một hermetic wheel closure chỉ được CI pipeline tạo ra, nên bạn được kỳ vọng pull image dựng sẵn từ GHCR thay vào đó.
- △SQLite chỉ được định vị là lựa chọn database cho dev, theo phần Helm của README — production được kỳ vọng chạy PostgreSQL.
Lựa Chọn Thay Thế ContextForge
ContextForge Phù Hợp Với Ai
ContextForge dành cho các team platform và hạ tầng đang chạy nhiều MCP server, API nội bộ, hay AI agent cần một điểm vào được quản trị tập trung thay vì tự nối dây riêng cho từng client — Admin UI, OAuth token theo scope, và tracing OpenTelemetry được xây cho đúng thực tế vận hành đó. Bỏ qua nếu bạn là một developer đơn lẻ chỉ chạy một MCP server local cho mục đích cá nhân: việc bắt buộc tạo secret, stack production chạy trên Postgres, và công cụ Kubernetes/Helm là overhead bạn không cần ở quy mô đó, và một MCP server trần hoặc một tool nhẹ hơn như toolhive sẽ giúp bạn chạy nhanh hơn.
Câu Hỏi Thường Gặp Về ContextForge
MCP là giao thức mà ContextForge hợp nhất chứ không phải giao thức do ContextForge định nghĩa — README mô tả ContextForge là registry và proxy đứng trước các MCP server, cho phép bạn chọn phiên bản MCP protocol, ví dụ 2025-11-25, cho từng kết nối, và bản thân ContextForge cũng chạy như một MCP server tuân thủ đầy đủ.
ContextForge hợp nhất MCP server, agent A2A (Agent-to-Agent) bao gồm định tuyến agent tương thích OpenAI và Anthropic, và API REST hay gRPC — các gRPC service được dịch tự động thành tool tuân thủ MCP qua reflection-based service discovery.
ContextForge triển khai được dưới dạng package PyPI (mcp-contextforge-gateway) chạy bằng pip hoặc uvx, container Docker hoặc Podman pull từ GHCR, qua Docker Compose cho full stack Postgres/Redis, hoặc qua Helm chart cho Kubernetes với autoscaling và Redis clustering nhiều replica.
ContextForge đi kèm một Admin UI, xây trên HTMX 2.0.3 và Alpine.js, cho quản lý thời gian thực, cấu hình, và một log viewer với filter, search, và export — README ghi rằng nó cũng hỗ trợ triển khai airgapped.
ContextForge bao gồm tracing OpenTelemetry với hỗ trợ Phoenix, Jaeger, Zipkin, Tempo, DataDog, và New Relic làm backend, cộng thêm structured log, health endpoint, metric, và các metric riêng cho LLM như token usage, chi phí, và hiệu năng model, không tốn thêm overhead khi tắt tracing, theo README.
ContextForge được xây hướng tới triển khai production, theo README: PostgreSQL là lựa chọn database cho production (SQLite dành cho dev), triển khai Kubernetes qua Helm gồm autoscaling và RBAC, và federation multi-cluster dựa trên Redis đi kèm SSRF protection nghiêm ngặt được bật mặc định.
Vấn đề ContextForge giải quyết
Khi bạn chạy nhiều hơn một hoặc hai MCP server, mỗi server lại thường muốn có auth scheme riêng, transport riêng (stdio, SSE, hay streamable-HTTP), và một chỗ riêng để gắn observability — khiến AI client phải xoay sở với một cách kết nối khác nhau cho từng tool thay vì một endpoint duy nhất. README của ContextForge đóng khung lý do dự án tồn tại quanh việc thu gọn sự phân mảnh đó: hợp nhất MCP, A2A, và REST/gRPC API đằng sau một gateway với governance, discovery, và observability tập trung, thay vì tích hợp riêng lẻ cho từng server.
Repo liên quan
Vẫn đang phân vân về mcp-context-forge?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về mcp-context-forge.