💍 MCP-сервер планировщика свадеб

Сервер Model Context Protocol (MCP), который подключает ИИ-ассистентов к шаблону планировщика свадеб в Google Таблицах. Управляйте свадебным бюджетом, списком гостей, расписанием и многим другим — и все это с помощью естественного языка через любой MCP-совместимый клиент.

✨ Функции

📋 Задачи и координация

Инструмент	Описание
`get_todos`	Получить все задачи
`add_todo`	Добавить новую задачу
`update_todo`	Обновить существующую задачу
`delete_todo`	Удалить задачу
`get_coordination`	Получить данные о координации подрядчиков
`update_coordination`	Обновить данные о координации подрядчиков

📅 Расписание

Инструмент	Описание
`get_schedule`	Получить расписание свадебного дня
`update_schedule`	Обновить запись в расписании
`delete_schedule`	Удалить запись из расписания

💰 Бюджет (Полный CRUD + управление категориями)

Инструмент	Описание
`get_budget_summary`	Обзор оценки бюджета
`get_detailed_budget`	Все пункты из детального бюджета
`add_budget_category`	Создать новую категорию (автоматическое копирование форматирования и формул)
`update_budget_category`	Переименовать категорию и/или обновить оценку
`delete_budget_category`	Удалить пользовательскую категорию (с защитой встроенных категорий)
`add_budget_item`	Добавить пункт в категорию (умная вставка строки)
`update_budget_item`	Обновить существующий пункт бюджета
`delete_budget_item`	Удалить пункт бюджета

👥 Список гостей

Инструмент	Описание
`get_guest_list`	Получить всех гостей с подробностями
`add_guest`	Добавить нового гостя
`update_guest`	Обновить информацию о госте по строке
`delete_guest`	Удалить гостя
`search_guests`	Поиск по имени, пригласившему или любому полю
`get_guest_summary`	Статистика: всего, подтвердивших участие, ответов, по пригласившему

💌 Приглашения

Инструмент	Описание
`get_invitations`	Получить сводные данные и список подрядчиков
`add_invitation_vendor`	Добавить нового подрядчика
`update_invitation_vendor`	Обновить данные подрядчика
`delete_invitation_vendor`	Удалить подрядчика

🛠 Предварительные требования

Node.js ≥ 22
Сервисный аккаунт Google Cloud с доступом к Sheets API
Таблица Google Sheets, основанная на шаблоне планировщика свадеб

⚡ Быстрый старт

1. Клонирование и установка

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

2. Настройка

Создайте файл .env:

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

Поместите учетные данные сервисного аккаунта GCP как gcp-service-account.json в корневой каталог проекта.

3. Сборка и запуск

npm run build
npm start

Сервер запустится на http://localhost:8080 с:

SSE-эндпоинт: http://localhost:8080/sse
Эндпоинт сообщений: http://localhost:8080/message

🐳 Docker

Сборка и запуск

docker compose up -d --build

docker-compose.yml

Включенный файл docker-compose.yml монтирует учетные данные GCP и открывает порт 8080. Настройте путь к тому в соответствии с расположением ваших учетных данных:

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

🔗 Подключение к MCP-клиенту

Gemini CLI / Antigravity

Добавьте в конфигурацию MCP:

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

Claude Desktop

Добавьте в claude_desktop_config.json:

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

📁 Структура проекта

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)

🔒 Примечания по безопасности

.env и gcp-service-account.json добавлены в gitignore — никогда не коммитьте секреты
Встроенные категории бюджета (Церемония, Банкет и т.д.) защищены от удаления
Дубликаты имен категорий отклоняются

📄 Лицензия

ISC

Wedding Planner MCP Server