Vibe Board MCP (ve-vibe-board)

Tu agente, pero con memoria. Servidor MCP respaldado por Firestore que le da a Claude Code (y a cualquier agente que hable MCP) memoria persistente entre sesiones: tareas, progreso, decisiones y notas de traspaso que sobreviven a la compactación del contexto y al fin de la sesión.

Repositorio complementario: HuntsDesk/ve-kit — Vibe Coding Framework y memoria persistente para Claude Code. ve-kit incluye este servidor MCP, un flujo de trabajo RIPER-CAT, ganchos de control de revisión y un trabajador Docker opcional.

Parte de Vibe Entrepreneurs: una comunidad para cualquier programador "vibe" que entrega trabajo real con IA. Ven a saludar: vibeentrepreneurs.com.

Por qué existe esto

¿Te suena familiar?

• Llevas seis llamadas a herramientas en una refactorización. El contexto se compacta. El agente vuelve con "vibes" pero sin un plan.

• Empiezas una nueva sesión mañana. Vuelve a leer los mismos archivos, vuelve a hacer las mismas preguntas, vuelve a decidir cosas que ya habías decidido.

• Lo viste escribir una lista de verificación perfecta en TodoWrite; luego la conversación terminó y la lista se evaporó con ella.

• Abriste tres agentes en paralelo. Ninguno sabe lo que hicieron los otros.

Esto es lo que se siente al no tener estado en la práctica. El agente es brillante durante una hora y amnésico para siempre después.

Donde va el estado es a Vibe Board. Es un tablero compartido de tareas + sesiones que vive fuera de cualquier conversación individual: en Firestore, no en el contexto.

• Los agentes crean tareas durante la planificación: sobreviven a la sesión.

• El progreso se rastrea durante la ejecución: visible para la siguiente ejecución.

• Las notas de traspaso se escriben cuando terminan las sesiones, con referencias a las tareas exactas que siguen abiertas.

• La siguiente sesión llama a board_create_session, lee el traspaso y se reanuda donde terminó la anterior.

Lo que obtienes: un agente que aparece el martes sabiendo lo que estaba haciendo el lunes. Sin volver a explicar. Sin planes perdidos. Sin cementerio de TodoWrite.

Gratis para ejecutar en el nivel gratuito de Firebase.

14 herramientas MCP

Catorce herramientas, un trabajo: darle al agente un lugar donde poner el estado que no sea la conversación.

Instalación

1. Clonar + construir

git clone https://github.com/HuntsDesk/ve-vibe-board.git
cd ve-vibe-board
npm install
npm run build

2. Configurar Firebase

Crea un proyecto de Firebase (el nivel gratuito funciona). Habilita Firestore en modo Nativo. Crea una cuenta de servicio con roles/datastore.user y descarga el JSON de la clave.

GOOGLE_APPLICATION_CREDENTIALS acepta ya sea una ruta de archivo a la clave JSON (canónico) o el contenido JSON sin procesar en línea (útil para entornos aislados como el Inspector MCP del navegador de Glama, secretos de CI o el patrón de secretos en línea de Cloud Run).

También crea 2 índices compuestos:

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=sessions \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending \
  --field-config field-path=ended_at,order=descending

gcloud firestore indexes composite create \
  --project=YOUR_PROJECT_ID \
  --collection-group=tasks \
  --field-config field-path=project_id,order=ascending \
  --field-config field-path=status,order=ascending

Espera de 1 a 5 minutos para que se construyan los índices.

3. Configurar Claude Code

Agrégalo al .mcp.json de tu proyecto:

{
  "mcpServers": {
    "vibe-board": {
      "command": "node",
      "args": ["/absolute/path/to/ve-vibe-board/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/your-key.json"
      }
    }
  }
}

Permite las herramientas en .claude/settings.local.json:

{
  "permissions": {
    "allow": [
      "mcp__vibe-board__board_get_projects",
      "mcp__vibe-board__board_create_project",
      "mcp__vibe-board__board_update_project",
      "mcp__vibe-board__board_get_tasks",
      "mcp__vibe-board__board_get_task",
      "mcp__vibe-board__board_create_task",
      "mcp__vibe-board__board_update_task",
      "mcp__vibe-board__board_bulk_update_tasks",
      "mcp__vibe-board__board_delete_task",
      "mcp__vibe-board__board_create_session",
      "mcp__vibe-board__board_end_session",
      "mcp__vibe-board__board_get_handoff",
      "mcp__vibe-board__board_log_activity",
      "mcp__vibe-board__board_get_activity"
    ]
  },
  "enabledMcpjsonServers": ["vibe-board"]
}

4. Verificar

Inicia una nueva sesión de Claude Code y llama a board_get_projects. Un array vacío = éxito.

Reglas del agente (pegar en CLAUDE.md)

## Vibe Board

Persistent task tracking across sessions via MCP tools (`board_*`).
**Mandatory for every substantive session.**

### Use board tasks, NOT TodoWrite
TodoWrite is ephemeral — dies when the session ends. Board tasks persist.
When you would reach for TodoWrite to track multi-step work, use
`board_create_task` instead.

### Session lifecycle
1. Call `board_create_session` at session start — returns last session's handoff
2. Create/update board tasks as you work
3. Call `board_end_session` with progress summary + handoff notes before stopping

El conjunto completo de reglas (disparadores proactivos, puertas de proceso, protocolo de revisión) está en HuntsDesk/ve-kit → docs/ve-kit/02-VIBE-BOARD.md.

Licencia

MIT. Ver LICENSE.

Relacionado

• HuntsDesk/ve-kit — Vibe Coding Framework completo que incluye este servidor MCP

• HuntsDesk/ve-gws — VE Google Workspace MCP (hermano en la familia ve-*)