Skip to main content
Glama
kiboud

Wedding Planner MCP Server

by kiboud

💍 婚礼策划 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

删除供应商

Related MCP server: Google Calendar MCP Server

🛠 先决条件

  • 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

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers