MCP REST Bridge

Español

English

Español

English

Appearance

MCP REST BridgeCualquier servidor REST, GraphQL o MCP → herramientas de IA seguras y gobernadas

El gateway MCP auto-hospedado con una UI de administración real. Auto-descubre tools desde OpenAPI, GraphQL, un comando cURL o una exportación Postman — o agrega otros servidores MCP. Guardrails por herramienta, RBAC y circuit breaking en un único binario. Sin Kubernetes.

Probar la demo en vivo ↗
Primeros pasos
⭐ Destacar en GitHub

Conecta cualquier cosa

Auto-descubre tools desde un spec OpenAPI o GraphQL, un comando cURL o una exportación Postman — o re-expón un servidor MCP existente. REST, GraphQL y MCP-a-MCP en un gateway.

Una UI de administración real

No es un montón de YAML. Un dashboard Vue 3 completo para servidores, bundles de herramientas, keys, uso, alertas, programaciones y el log de auditoría.

Seguro por defecto

Protección SSRF + DNS-rebinding con anclaje de IP, sanitización de prompt-injection, detección de secretos y restricciones fail-closed de keys por herramienta — integrado, no como plugin.

Gobernanza por herramienta

Rate limits, timeouts y reglas de keys permitidas en cualquier herramienta, más circuit breakers por cliente. RBAC (admin / operator / auditor / viewer) más multi-tenancy por equipos.

Observable y auditable

Prometheus /metrics, tracing OpenTelemetry por llamada, alertas de anomalías de uso y un log de auditoría encadenado por hash, a prueba de manipulaciones, con stream a SIEM.

Ejecuta en cualquier sitio

Proceso único Bun con almacenamiento bun:sqlite. Sin base de datos externa, sin Kubernetes. Una imagen Docker, o `bun src/index.ts`.

Míralo en acción ​

Todo el bridge se gestiona desde un dashboard integrado — registra backends, cura lo que ve cada cliente y observa salud, uso y rastros de auditoría en vivo.

MCP REST Bridge admin — OverviewMCP REST Bridge admin — ServersMCP REST Bridge admin — Usage▶ Open the live demo

🎮 Prueba la demo en vivo → — la UI de administración real ejecutándose con datos mock, directamente en tu navegador. Sin instalación, sin registro.

Convierte cualquier cosa a MCP

Seis formas de convertir un backend en tools MCP gobernadas — todas por la misma guard pipeline.

openapi_url

OpenAPI / Swagger

Auto-descubre una tool MCP por operación desde el spec.

graphql_url

GraphQL

Introspecciona el schema — una tool por query y mutation.

curl_input

Comando cURL

Pega una invocación curl que funcione y obtén una tool.

postman_collection

Postman

Una tool por request en una colección v2.1.

tools[]

Manual

¿Sin spec? Escribe a mano exactamente las tools que necesitas.

kind: "mcp"

Servidor MCP

Re-expón las tools de un servidor MCP existente, ya gobernadas.

Ver todos los caminos de registro →

Quickstart de 60 segundos ​

bash
docker build -t mcpbridge .

export ADMIN_API_KEY=$(openssl rand -hex 24)

docker run -p 3000:3000 \
  -e NODE_ENV=development \
  -e SESSION_COOKIE_SECURE=false \
  -e BOOTSTRAP_ADMIN_USERNAME=admin \
  -e BOOTSTRAP_ADMIN_PASSWORD=change-me-min-12-chars \
  -e ADMIN_API_KEYS=$ADMIN_API_KEY \
  -v "$PWD/data:/app/data" \
  mcpbridge

Abre http://localhost:3000/admin, inicia sesión y añade tu primer servidor. $ADMIN_API_KEY es el token Bearer que usan los ejemplos curl/CLI a lo largo de esta documentación — mantenlo exportado en la misma shell. Luego apunta cualquier cliente MCP al shard de ese backend — http://localhost:3000/mcp/<tu-servidor> — o cura un bundle para servir varios backends tras un solo endpoint. Tutorial completo en Primeros pasos →

Cómo funciona ​

How MCP REST Bridge works AI clients send tool calls over MCP; the bridge runs each call through SSRF checks, guardrails, per-tool policy, circuit breakers and an audit log, then dispatches it to your REST APIs or upstream MCP servers. AI CLIENTSYOUR BACKENDSSSRFGuardrailsBreakerDispatchAuditMCP REST Bridgeone governed path for every callGUARD PIPELINEClaudeCursorAgents & IDEsREST / OpenAPIMCP upstreamsMCPRESTMCP
Tool calls in over MCP — dispatched out to your REST APIs or MCP servers, through the full guard stack on every hop.

Sirve tools de backend de dos maneras: por cliente /mcp/:name para un backend, o un bundle curado /mcp-custom/:bundle para poner varios tras un solo endpoint. La raíz /mcp es el control plane — tools sys_* que un agente usa para operar el gateway, no tools de backend. (Cómo los bundles agregan varios backends →)

Por qué los equipos lo eligen ​

  • La UI es el producto. La mayoría de gateways MCP open-source son solo ficheros de config. Este trae un dashboard que realmente le pasarías a un compañero.
  • Una herramienta, dos direcciones. Bridge de APIs REST y agregador de servidores MCP tras un único endpoint gobernado.
  • La seguridad no es un añadido. SSRF, sanitización de inyección y detección de secretos están activadas por defecto, en cada path.
  • Sin infraestructura pesada. Sin Kubernetes, sin Postgres, sin sidecars. Un binario y un fichero SQLite.
  • Testeado de verdad. 330+ ficheros de test en el backend, Vitest, e2e con Playwright y mutation testing con Stryker — cobertura que mide si los tests atrapan bugs, no solo si ejecutan líneas.

Distribuido bajo la licencia MIT · Construido con Bun + Vue.

Código abierto · https://github.com/CarlxsMG/mcpbridge