💍 婚礼策划 MCP 服务器

一个模型上下文协议 (MCP) 服务器，将 AI 助手连接到 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
具有 Sheets API 访问权限的 Google Cloud 服务账号
基于婚礼策划模板的 Google 表格电子表格

⚡ 快速开始

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