💍 Hochzeitsplaner MCP-Server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten mit einer Google Sheets-Hochzeitsplaner-Vorlage verbindet. Verwalten Sie Ihr Hochzeitsbudget, Ihre Gästeliste, Ihren Zeitplan und mehr – alles per natürlicher Sprache über jeden MCP-kompatiblen Client.

✨ Funktionen

📋 Aufgaben & Koordination

Tool	Beschreibung
`get_todos`	Alle Aufgaben abrufen
`add_todo`	Eine neue Aufgabe hinzufügen
`update_todo`	Eine bestehende Aufgabe aktualisieren
`delete_todo`	Eine Aufgabe löschen
`get_coordination`	Koordinationsdaten für Dienstleister abrufen
`update_coordination`	Dienstleister-Koordination aktualisieren

📅 Zeitplan

Tool	Beschreibung
`get_schedule`	Den Zeitplan für den Hochzeitstag abrufen
`update_schedule`	Einen Eintrag im Zeitplan aktualisieren
`delete_schedule`	Einen Eintrag aus dem Zeitplan löschen

💰 Budget (Vollständiges CRUD + Kategorienverwaltung)

Tool	Beschreibung
`get_budget_summary`	Übersicht der Budgetschätzung
`get_detailed_budget`	Alle Posten aus dem detaillierten Budget abrufen
`add_budget_category`	Neue Kategorie erstellen (klont automatisch Formatierung & Formeln)
`update_budget_category`	Kategorie umbenennen und/oder Schätzung aktualisieren
`delete_budget_category`	Benutzerdefinierte Kategorie löschen (mit Schutz für integrierte Kategorien)
`add_budget_item`	Posten zu einer Kategorie hinzufügen (intelligentes Einfügen von Zeilen)
`update_budget_item`	Bestehenden Budgetposten aktualisieren
`delete_budget_item`	Budgetposten löschen

👥 Gästeliste

Tool	Beschreibung
`get_guest_list`	Alle Gäste mit Details abrufen
`add_guest`	Einen neuen Gast hinzufügen
`update_guest`	Gastinformationen zeilenweise aktualisieren
`delete_guest`	Einen Gast löschen
`search_guests`	Nach Name, eingeladenVon oder einem beliebigen Feld suchen
`get_guest_summary`	Statistik: Gesamtanzahl, Zusagen, Antworten, nach eingeladenVon

💌 Einladungen

Tool	Beschreibung
`get_invitations`	Zusammenfassende Zählungen und Dienstleisterliste abrufen
`add_invitation_vendor`	Einen neuen Dienstleister hinzufügen
`update_invitation_vendor`	Dienstleisterdetails aktualisieren
`delete_invitation_vendor`	Einen Dienstleister löschen

🛠 Voraussetzungen

Node.js ≥ 22
Google Cloud Service Account mit Zugriff auf die Sheets API
Eine Google Sheets-Tabelle basierend auf der Hochzeitsplaner-Vorlage

⚡ Schnellstart

1. Klonen & Installieren

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

2. Konfigurieren

Erstellen Sie eine .env-Datei:

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

Platzieren Sie Ihre GCP-Service-Account-Anmeldedaten als gcp-service-account.json im Projektstammverzeichnis.

3. Erstellen & Ausführen

npm run build
npm start

Der Server startet unter http://localhost:8080 mit:

SSE-Endpunkt: http://localhost:8080/sse
Nachrichten-Endpunkt: http://localhost:8080/message

🐳 Docker

Erstellen & Ausführen

docker compose up -d --build

docker-compose.yml

Die enthaltene docker-compose.yml bindet die GCP-Anmeldedaten ein und stellt Port 8080 bereit. Passen Sie den Volume-Pfad an den Speicherort Ihrer Anmeldedaten an:

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

🔗 Verbindung zu einem MCP-Client herstellen

Gemini CLI / Antigravity

Fügen Sie dies zu Ihrer MCP-Konfiguration hinzu:

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

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

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

📁 Projektstruktur

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)

🔒 Sicherheitshinweise

.env und gcp-service-account.json sind in .gitignore enthalten – committen Sie niemals Geheimnisse
Integrierte Budgetkategorien (Zeremonie, Empfang usw.) sind vor dem Löschen geschützt
Doppelte Kategoriennamen werden abgelehnt

📄 Lizenz

ISC

Wedding Planner MCP Server