Minibridge

Minibridge

Minibridge sirve como un puente entre el backend y el frontend, optimizando y asegurando la comunicación entre Agentes y servidores MCP. Expone de forma segura servidores MCP a internet y puede integrarse opcionalmente con servicios de control genéricos — conocidos como Policers — para la autenticación de agentes, análisis de contenido y transformación. Los Policers pueden implementarse de forma remota mediante HTTP o localmente usando políticas de OPA Rego.

Minibridge puede ayudar a garantizar la integridad de los servidores MCP mediante la generación de SBOM (Software Bill of Materials) y la validación en tiempo real.

Además, Minibridge es compatible con OTEL y puede reportar/reasociar spans desde cabeceras OTEL clásicas, así como directamente desde la llamada MCP, tal como lo insertan ciertas herramientas como Open Inference.

• Minibridge Frontend: El Cliente se conecta a la parte Frontend de Minibridge.
• Minibridge Backend: El Frontend se conecta al Backend que envuelve el servidor MCP.
• Minibridge Policer: El Policer se ejecuta en el Backend y puede tomar decisiones opcionalmente sobre la entrada y la salida basándose en algunas políticas (localmente con Rego o remotamente usando HTTPs).

[!TIP] De forma conveniente, Minibridge puede iniciarse en modo "all-in-one" (AIO) para actuar como un único proceso.

¿Por qué usar Minibridge?

Minibridge cubre lo siguiente:

• Transporte Seguro: Usa TLS con, opcionalmente, validación de certificados de cliente
• Integridad: Garantiza que el servidor MCP no pueda mutar herramientas, plantillas, etc. durante la ejecución
• Autenticación de Usuario: Transporta la información del usuario al Policer
• Monitorización: Expone métricas de Prometheus
• Telemetría: Reporta trazas y spans usando Opentelemetry

Instalación

Minibridge puede instalarse desde varios lugares:

Homebrew

En macOS, puedes usar Homebrew

brew tap acuvity/tap
brew install minibridge

AUR

En distribuciones Linux basadas en Arch, puedes ejecutar:

yay -S minibridge

Alternativamente, para obtener la última versión desde la rama principal:

yay -S minibridge-git

Go

Si tienes instalado el toolchain de Go:

go install go.acuvity.ai/minibridge@latest

Alternativamente, para obtener la última versión desde la rama principal:

go install go.acuvity.ai/minibridge@main

Manualmente

Puedes obtener fácilmente una versión binaria para tu plataforma desde la página de lanzamientos.

Comparación de características

🚀 Característica	🔹 MCP	🔸 Minibridge	📦 ARC (Acuvity Containers)
🌐 Acceso Remoto	⚠️	✅	✅
🔒 Soporte TLS	❌	✅	✅
📃 Verificación de integridad de herramientas	❌	✅	✅
📊 Visualización y Trazado	❌	✅	✅
🛡️ Aislamiento	❌	⚠️	✅
🔐 Gestión de Políticas de Seguridad	❌	👤	⚠️
🕵️ Redacción de Secretos	❌	👤	⚠️
🔑 Controles de Autorización	❌	👤	👤
🧑‍💻 Detección y Redacción de PII	❌	👤	👤
📌 Fijación de Versiones	❌	❌	✅

✅ Incluido | ⚠️ Soporte Parcial/Básico | 👤 Implementación Personalizada del Usuario | ❌ No Soportado

Ejemplo: Configurando Minibridge en tu Cliente MCP

Supongamos que tu configuración de cliente especifica originalmente un servidor MCP de esta manera:

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Para enrutar las solicitudes a través de Minibridge (habilitando verificaciones SBOM, aplicación de políticas, etc.), actualiza la entrada:

{
  "mcpServers": {
    "fetch": {
      "command": "minibridge",
      "args": ["aio", "--", "uvx", "mcp-server-fetch"]
    }
  }
}

• minibridge aio: Invoca Minibridge en modo "all-in-one", envolviendo la herramienta downstream.
• uvx mcp-server-fetch: El comando original del servidor MCP, ahora ejecutado dentro de Minibridge.

[!TIP] La ubicación de los archivos de configuración depende de tu Cliente. Por ejemplo, si usas Claude Desktop, los archivos de configuración se encuentran en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Consulta la documentación oficial de MCP QuickStart para usuarios de Claude Desktop.

[!IMPORTANT] Tu cliente debe poder resolver la ruta del binario. Si ves un error como MCP fetch: spawn minibridge ENOENT, establece el parámetro command anterior a la ruta completa de minibridge (which minibridge te dará la ruta completa).

Documentación

Consulta la documentación completa en las páginas wiki.

Contribuye

¡Estamos emocionados de dar la bienvenida a contribuciones de todos! 🎉 Ya sea corrigiendo errores, mejorando características, mejorando la documentación o proponiendo ideas completamente nuevas, tu participación ayuda a fortalecer el proyecto y beneficia a toda la comunidad.

No necesitas firmar un Acuerdo de Licencia de Colaborador (CLA) — ¡solo abre un pull request y colaboremos!

Únete a nosotros

• Discord
• LinkedIn
• Bluesky
• Docker