bot-relay-mcp
Bus de coordinación local-first para agentes de IA usando SQLite y TypeScript. Conecta agentes heterogéneos (Claude Code, Cursor, n8n) sin nube ni dependencias externas. Ofrece autowake hands-free y persistencia de estado.
Ficha actualizada 24 sept 2026, 9:36 · upstream 24 sept 2026, 9:27 · release v3.0.1
Qué es bot-relay-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
bot-relay-mcp es un primitivo de coordinación diseñado para flujos de trabajo multi-agente en entornos locales. Funciona como un bus de mensajes durable que conecta agentes de IA (Claude Code, Cursor, Cline, Zed) con sistemas externos (n8n, Slack, scripts personalizados). Utiliza una base de datos SQLite compartida y dos interfaces: stdio MCP para agentes y HTTP+SSE para sistemas externos. No requiere infraestructura compleja ni cuentas en la nube.
La arquitectura es LLM-agnóstica, permitiendo que cualquier cliente MCP se registre y comunique con otros sin privilegios específicos. El sistema soporta autowake hands-free mediante extensiones como Tether VSCode o Sentinel para terminales externos. Los mensajes, tareas y canales persisten entre sesiones de agentes, sobreviviendo a reinicios o cierres de terminal.
El despliegue es sencillo: una entrada en ~/.claude.json activa el servidor local. La inicialización (relay init) configura automáticamente la base de datos, hooks de inicio de sesión y daemons opcionales. El sistema incluye herramientas para registro de agentes, envío de mensajes, tareas con asignación automática y webhooks.
- Coordinación entre múltiples agentes de IA en un mismo proyecto (Claude Code + Cursor)
- Integración de flujos externos (n8n) con agentes locales mediante webhooks HTTP+SSE
- Autowake hands-free para que los agentes procesen mensajes sin polling manual
- Asignación automática de tareas a agentes según capacidades requeridas
- Arquitectura local-first con SQLite, sin nube ni vendor lock-in
- LLM-agnóstico: soporta múltiples clientes MCP y sistemas HTTP simultáneamente
- Autowake hands-free mediante Tether VSCode o Sentinel (polling/markers)
- Persistencia durable de mensajes y tareas entre sesiones de agentes
- No soporta Docker ni despliegue containerizado nativo
- Requiere configuración manual en ~/.claude.json o instalación global npm
- El daemon HTTP no está supervisado automáticamente en Linux/Windows (v2.1)
- Seguridad local-trust por defecto sin secret para hosts no loopback
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía npm o desde fuente. Ejecutar relay init para configuración automática. Para producción, usar --secret en inicialización HTTP y supervisar el daemon manualmente en Linux/Windows. Asegurar permisos 0700 en ~/.bot-relay/.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.