💍 Servidor MCP de Planificador de Bodas

Un servidor del Protocolo de Contexto de Modelo (MCP) que conecta asistentes de IA a una plantilla de Google Sheets para planificar bodas. Gestiona tu presupuesto de boda, lista de invitados, cronograma y más, todo a través de lenguaje natural mediante cualquier cliente compatible con MCP.

✨ Características

📋 Tareas y Coordinación

Herramienta	Descripción
`get_todos`	Obtener todas las tareas
`add_todo`	Añadir una nueva tarea
`update_todo`	Actualizar una tarea existente
`delete_todo`	Eliminar una tarea
`get_coordination`	Obtener datos de coordinación de proveedores
`update_coordination`	Actualizar la coordinación de proveedores

📅 Cronograma

Herramienta	Descripción
`get_schedule`	Obtener el cronograma del día de la boda
`update_schedule`	Actualizar una entrada del cronograma
`delete_schedule`	Borrar una entrada del cronograma

💰 Presupuesto (CRUD completo + Gestión de categorías)

Herramienta	Descripción
`get_budget_summary`	Resumen del estimador de presupuesto
`get_detailed_budget`	Todos los elementos del presupuesto detallado
`add_budget_category`	Crear nueva categoría (clona automáticamente formato y fórmulas)
`update_budget_category`	Renombrar categoría y/o actualizar estimación
`delete_budget_category`	Eliminar categoría personalizada (con protección para categorías integradas)
`add_budget_item`	Añadir elemento a una categoría (inserción inteligente de filas)
`update_budget_item`	Actualizar un elemento de presupuesto existente
`delete_budget_item`	Eliminar un elemento de presupuesto

👥 Lista de Invitados

Herramienta	Descripción
`get_guest_list`	Obtener todos los invitados con detalles
`add_guest`	Añadir un nuevo invitado
`update_guest`	Actualizar información del invitado por fila
`delete_guest`	Eliminar un invitado
`search_guests`	Buscar por nombre, invitadoPor, o cualquier campo
`get_guest_summary`	Estadísticas: total, asistentes, respuestas, por invitadoPor

💌 Invitaciones

Herramienta	Descripción
`get_invitations`	Obtener recuentos resumidos y lista de proveedores
`add_invitation_vendor`	Añadir un nuevo proveedor
`update_invitation_vendor`	Actualizar detalles del proveedor
`delete_invitation_vendor`	Eliminar un proveedor

🛠 Requisitos previos

Node.js ≥ 22
Cuenta de servicio de Google Cloud con acceso a la API de Sheets
Una hoja de cálculo de Google Sheets basada en la plantilla de planificador de bodas

⚡ Inicio rápido

1. Clonar e instalar

git clone https://github.com/kiboud/weddingplanner_mcp.git
cd weddingplanner_mcp
npm install

2. Configurar

Crea un archivo .env:

SPREADSHEET_ID=your_google_spreadsheet_id_here
GOOGLE_APPLICATION_CREDENTIALS=./gcp-service-account.json
PORT=8080

Coloca tus credenciales de cuenta de servicio de GCP como gcp-service-account.json en la raíz del proyecto.

3. Construir y ejecutar

npm run build
npm start

El servidor se iniciará en http://localhost:8080 con:

Endpoint SSE: http://localhost:8080/sse
Endpoint de mensajes: http://localhost:8080/message

🐳 Docker

Construir y ejecutar

docker compose up -d --build

docker-compose.yml

El archivo docker-compose.yml incluido monta las credenciales de GCP y expone el puerto 8080. Ajusta la ruta del volumen para que coincida con la ubicación de tus credenciales:

volumes:
  - /path/to/gcp-service-account.json:/root/.openclaw/workspace-wedding/gcp-service-account.json:ro

🔗 Conectar a un cliente MCP

Gemini CLI / Antigravity

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "wedding-planner": {
      "url": "http://localhost:8080/sse"
    }
  }
}

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "wedding-planner": {
      "url": "http://localhost:8080/sse"
    }
  }
}

📁 Estructura del proyecto

weddingplanner_mcp/
├── src/
│   ├── index.ts           # MCP server + tool registry
│   └── google-sheets.ts   # Google Sheets API service layer
├── build/                 # Compiled JS (gitignored)
├── Dockerfile
├── docker-compose.yml
├── tsconfig.json
├── package.json
└── .env                   # Config (gitignored)

🔒 Notas de seguridad

.env y gcp-service-account.json están en gitignore — nunca subas secretos al repositorio
Las categorías de presupuesto integradas (Ceremonia, Recepción, etc.) están protegidas contra eliminación
Los nombres de categoría duplicados son rechazados

📄 Licencia

ISC

Wedding Planner MCP Server