💍 ウェディングプランナー MCP サーバー

Model Context Protocol (MCP) サーバーは、AI アシスタントを Google スプレッドシートのウェディングプランナーテンプレートに接続します。MCP 対応クライアントを通じて、自然言語で結婚式の予算、ゲストリスト、スケジュールなどを管理できます。

✨ 機能

📋 To-Do & 調整

ツール	説明
`get_todos`	すべての To-Do アイテムを取得
`add_todo`	新しい To-Do アイテムを追加
`update_todo`	既存の To-Do を更新
`delete_todo`	To-Do アイテムを削除
`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