Skip to main content
Glama
kiboud

Wedding Planner MCP Server

by kiboud

💍 웨딩 플래너 MCP 서버

AI 어시스턴트를 Google 스프레드시트 웨딩 플래너 템플릿에 연결하는 Model Context Protocol (MCP) 서버입니다. 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