Reservation Platform MCP Server

# PlayMCP 등록 정보 ## 🎯 서버 기본 정보 **서버 이름:** 예약 플랫폼 통합 관리 **영문 이름:** Reservation Platform Manager **카테고리:** 생산성 / 비즈니스 도구 **서버 URL:** https://reservation-platform-mcp-server-production.up.railway.app/mcp ## 📖 서버 설명 여러 예약 플랫폼(네이버, 에어비앤비, 스페이스클라우드, 야놀자, 카카오)의 **실제 예약 데이터**를 iCal 표준을 통해 한 곳에서 통합 관리하는 MCP 서버입니다. **주요 특징:** - ✅ **실제 플랫폼 연동**: iCal URL을 통한 실시간 예약 데이터 동기화 - 🔄 **자동 동기화**: 서버 시작 시 및 주기적(1시간) 자동 예약 업데이트 - 🔗 **5개 주요 플랫폼 지원**: 에어비앤비, 네이버, 스페이스클라우드, 야놀자, 카카오 - ⚠️ **중복 예약 방지**: 여러 플랫폼의 예약 시간 충돌 자동 감지 - 💰 **매출 분석**: 플랫폼별 매출 및 수수료 자동 계산 - 👥 **고객 관리**: 블랙리스트, 노쇼 고객 추적 - 📅 **iCal 표준**: 모든 예약 플랫폼과 호환 가능 - 📝 **메시지 자동 생성**: 예약 안내 메시지 템플릿 **실제 연동 방법:** 각 플랫폼의 iCal URL을 환경 변수(.env)에 설정하면 자동으로 예약 데이터를 가져옵니다. 자세한 설정 방법은 프로젝트의 ICAL_SETUP_GUIDE.md 문서를 참고하세요. **대상 사용자:** - 파티룸, 스터디룸, 공유 오피스 등 공간 대여 사업자 - 여러 플랫폼에서 예약을 받는 모든 비즈니스 - 예약 관리 자동화가 필요한 개인/기업 ## 🛠️ 제공 Tools (13개) ### 📊 예약 조회 (4개) #### 1. get_today_reservations **설명:** 오늘의 모든 예약 현황을 시간순으로 조회합니다. **파라미터:** 없음 **반환값:** 오늘 예약 목록 (플랫폼, 시간, 고객명, 금액) **사용 예시:** ``` User: 오늘 예약 현황 알려줘 Claude: [get_today_reservations 실행] 오늘은 2건의 예약이 있습니다. • [airbnb] 14:00-18:00 | 김철수 | 120,000원 • [naver] 19:00-22:00 | 이영희 | 80,000원 ``` #### 2. get_reservations_by_date **설명:** 특정 날짜의 예약 현황을 조회합니다. **파라미터:** - `target_date` (string): 조회할 날짜 (YYYY-MM-DD 형식) **반환값:** 해당 날짜의 모든 예약 목록 **사용 예시:** ``` User: 내일(2026-01-09) 예약 있어? Claude: [get_reservations_by_date 실행] 2026-01-09에는 3건의 예약이 있습니다... ``` #### 3. get_reservations_by_platform **설명:** 특정 플랫폼의 모든 예약을 조회합니다. **파라미터:** - `platform` (string): 플랫폼 이름 (airbnb, spacecloud, naver, yanolja, kakao) **반환값:** 해당 플랫폼의 예약 목록 (최근 20건) **사용 예시:** ``` User: 에어비앤비 예약 목록 보여줘 Claude: [get_reservations_by_platform 실행] AIRBNB 예약 목록 (15건)... ``` #### 4. get_week_reservations **설명:** 이번 주(월~일)의 모든 예약을 날짜별로 조회합니다. **파라미터:** 없음 **반환값:** 이번 주 예약 목록 (날짜별 그룹핑) **사용 예시:** ``` User: 이번 주 예약 현황은? Claude: [get_week_reservations 실행] 이번 주(01/06 ~ 01/12) 예약 현황 (8건) 01/08(수) • [airbnb] 14:00-18:00 | 김철수 | 120,000원 01/09(목) • [naver] 10:00-14:00 | 박민수 | 90,000원 ... ``` --- ### ⚠️ 중복 예약 방지 (2개) #### 5. check_duplicate_reservations **설명:** 현재 등록된 모든 예약 중 시간이 겹치는 중복 예약을 자동으로 감지합니다. **파라미터:** 없음 **반환값:** 중복된 예약 목록 (없으면 "중복 없음") **사용 예시:** ``` User: 중복 예약 있는지 확인해줘 Claude: [check_duplicate_reservations 실행] ⚠️ 중복 예약 발견! (1건) • 2026-01-09 14:00 - 18:00 - [airbnb] 김철수 - [naver] 이영희 ``` #### 6. check_time_slot **설명:** 특정 시간대에 예약이 가능한지 확인하고, 충돌하는 예약을 알려줍니다. **파라미터:** - `start_time` (string): 시작 시간 (YYYY-MM-DD HH:MM) - `end_time` (string): 종료 시간 (YYYY-MM-DD HH:MM) **반환값:** 예약 가능 여부 및 충돌 정보 **사용 예시:** ``` User: 내일 15시에 4시간 예약 가능해? Claude: [check_time_slot 실행] ✅ 2026-01-09 15:00 ~ 19:00 예약 가능합니다! ``` --- ### 💰 매출/정산 관리 (2개) #### 7. get_revenue_summary **설명:** 기간별(오늘/이번 주/이번 달) 매출을 요약하고 플랫폼별 통계를 제공합니다. **파라미터:** - `period` (string, optional): 기간 (today, week, month) - 기본값: month **반환값:** 총 매출, 예약 건수, 평균 금액, 플랫폼별 매출 **사용 예시:** ``` User: 이번 달 매출 얼마야? Claude: [get_revenue_summary 실행] 💰 2026년 1월 매출 요약 총 매출: 2,450,000원 총 예약: 18건 평균 금액: 136,111원 플랫폼별 매출: • airbnb: 950,000원 (7건) • naver: 680,000원 (6건) • spacecloud: 520,000원 (3건) ... ``` #### 8. calculate_platform_fees **설명:** 각 플랫폼의 수수료를 자동 계산하고, 총 매출, 수수료, 순수익을 요약합니다. **파라미터:** 없음 **반환값:** 플랫폼별 매출, 수수료율, 수수료 금액, 순수익 **사용 예시:** ``` User: 플랫폼 수수료 계산해줘 Claude: [calculate_platform_fees 실행] 💳 플랫폼 수수료 계산 [AIRBNB] 매출: 950,000원 (7건) 수수료(15.0%): 142,500원 순수익: 807,500원 [NAVER] 매출: 680,000원 (6건) 수수료(5.0%): 34,000원 순수익: 646,000원 ──────────────────────────────────── 총 매출: 2,450,000원 총 수수료: 245,000원 총 순수익: 2,205,000원 ``` --- ### 👥 고객 관리 (3개) #### 9. get_blacklist **설명:** 블랙리스트에 등록된 고객 목록을 조회합니다. **파라미터:** 없음 **반환값:** 블랙리스트 고객 목록 (이름, 연락처, 노쇼 횟수, 메모) **사용 예시:** ``` User: 블랙리스트 고객 알려줘 Claude: [get_blacklist 실행] 🚫 블랙리스트 (2명) • 김XX (010-1234-5678) 노쇼 3회 | 총 예약 5회 메모: 반복적인 노쇼로 블랙리스트 등록 ``` #### 10. add_to_blacklist **설명:** 특정 고객을 블랙리스트에 추가합니다. **파라미터:** - `phone` (string): 고객 연락처 - `name` (string): 고객 이름 - `reason` (string, optional): 블랙리스트 등록 사유 **반환값:** 등록 완료 메시지 **사용 예시:** ``` User: 010-9999-8888 이영희님 블랙리스트 추가해줘. 노쇼 3번 했어. Claude: [add_to_blacklist 실행] ✅ 이영희(010-9999-8888)님을 블랙리스트에 추가했습니다. ``` #### 11. get_noshow_customers **설명:** 노쇼 이력이 있는 고객 목록을 조회합니다. **파라미터:** - `min_count` (int, optional): 최소 노쇼 횟수 (기본값: 1) **반환값:** 노쇼 고객 목록 (노쇼 횟수 내림차순) **사용 예시:** ``` User: 노쇼 2회 이상 고객 찾아줘 Claude: [get_noshow_customers 실행] ⚠️ 노쇼 2회 이상 고객 (3명) • 김XX (010-1234-5678) 🚫 블랙리스트 노쇼 3회 | 총 예약 5회 • 박OO (010-2345-6789) 노쇼 2회 | 총 예약 8회 ``` --- ### 📝 기타 기능 (2개) #### 12. generate_reminder_message **설명:** 특정 날짜의 예약 고객들에게 보낼 안내 메시지를 자동으로 생성합니다. **파라미터:** - `reservation_date` (string): 예약 날짜 (YYYY-MM-DD) **반환값:** 고객별 맞춤 안내 메시지 **사용 예시:** ``` User: 내일 예약 고객들한테 보낼 안내 메시지 만들어줘 Claude: [generate_reminder_message 실행] 📨 2026-01-09 예약 안내 메시지 [김철수님 - 14:00] 안녕하세요, 김철수님! 2026년 01월 09일 14:00 예약 안내드립니다. 예약 시간: 14:00 ~ 18:00 예약 금액: 120,000원 즐거운 시간 되시길 바랍니다! ──────────────────────────────────── ... ``` #### 13. sync_platform_ical ⭐ **설명:** **실제 플랫폼의 iCal URL에서 예약 데이터를 실시간으로 가져와 동기화합니다.** **파라미터:** - `platform` (string): 플랫폼 이름 (airbnb, spacecloud, naver, yanolja, kakao) - `ical_url` (string): **실제 플랫폼의 iCal 캘린더 URL** (각 플랫폼 설정에서 확인) **반환값:** 동기화 결과 (성공/실패 및 동기화된 예약 수) **중요:** - 이 Tool은 실제 예약 플랫폼과 연동됩니다 - 각 플랫폼에서 제공하는 iCal URL을 사용하여 실시간 예약 정보를 가져옵니다 - 서버는 1시간마다 자동으로 동기화하며, 이 Tool로 수동 동기화도 가능합니다 **사용 예시:** ``` User: 에어비앤비 최신 예약 가져와줘 Claude: [sync_platform_ical 실행] ✅ airbnb에서 12건의 예약을 동기화했습니다. (실제 에어비앤비 캘린더의 최신 예약 데이터) ``` --- ## 🎯 강점 및 차별점 ### 1. ✅ 실제 플랫폼 연동 (핵심 강점) - **실제 예약 데이터** 사용: 각 플랫폼의 iCal URL을 통한 실시간 동기화 - **자동 업데이트**: 서버 시작 시 및 주기적(1시간) 자동 동기화 - **검증 가능**: 실제 에어비앤비, 네이버 예약 등의 iCal URL로 즉시 테스트 가능 - 샘플 데이터가 아닌 **실제 운영 데이터** 기반 ### 2. 실용성 - 실제 공간 대여 비즈니스의 Pain Point 해결 - 여러 플랫폼을 하나의 인터페이스로 통합 관리 - 중복 예약으로 인한 손실 방지 ### 3. 확장성 - iCal 표준 사용으로 모든 예약 플랫폼 적용 가능 - 현재 5개 플랫폼 지원, 추가 플랫폼 확장 용이 - Google Calendar, Outlook 등 일반 캘린더도 연동 가능 ### 4. 완성도 - 13개 Tools, 모두 실제 데이터로 작동 - 예약 조회부터 매출 분석까지 전체 워크플로우 지원 - 자동 동기화 + 수동 동기화 모두 지원 ### 5. 차별성 - **실제 플랫폼 연동**: 샘플 데이터가 아닌 실시간 데이터 - 예약 플랫폼 통합 관리는 MCP 생태계에서 유일 - 중복 예약 자동 감지 등 실무 필수 기능 구현 ### 6. 성장 가능성 - 숙박, 레스토랑, 스터디룸, 강의실, 미용실 등 모든 예약 비즈니스 적용 - AI 기반 예약 최적화, 동적 가격 책정 등 확장 가능 - 고객 행동 패턴 분석, 예측 등 고급 기능 추가 가능 --- ## 📊 사용 시나리오 ### 시나리오 1: 일일 예약 관리 ``` 호스트: 오늘 예약 현황 알려줘 → [get_today_reservations] 호스트: 중복 예약 있어? → [check_duplicate_reservations] 호스트: 내일 고객들한테 보낼 안내 메시지 만들어줘 → [generate_reminder_message] ``` ### 시나리오 2: 매출 분석 ``` 사업자: 이번 달 매출 얼마야? → [get_revenue_summary] 사업자: 플랫폼별 수수료 계산해줘 → [calculate_platform_fees] 사업자: 에어비앤비 예약만 따로 볼 수 있어? → [get_reservations_by_platform] ``` ### 시나리오 3: 고객 관리 ``` 운영자: 노쇼 2회 이상 고객 찾아줘 → [get_noshow_customers] 운영자: 010-1234-5678 블랙리스트 추가해줘 → [add_to_blacklist] 운영자: 블랙리스트 고객 목록 보여줘 → [get_blacklist] ``` --- ## 🚀 배포 정보 **플랫폼:** Railway **배포 URL:** https://reservation-platform-mcp-server-production.up.railway.app/mcp **프로토콜:** MCP over HTTP (SSE) **상태:** ✅ 정상 운영 중 --- ## 📞 지원 및 문의 **개발자:** pak3430 **GitHub:** (저장소 URL 추가 예정) **문서:** README.md, DEPLOYMENT.md --- ## 📅 로드맵 ### 단기 (1-2개월) - [ ] 예약 수동 추가/수정/삭제 Tools - [ ] 실시간 알림 기능 - [ ] 통계 차트 데이터 제공 ### 중기 (3-6개월) - [ ] 데이터베이스 연동 (PostgreSQL) - [ ] 웹 대시보드 (React) - [ ] 카카오톡 알림톡 연동 ### 장기 (6개월+) - [ ] AI 기반 예약 최적화 - [ ] 동적 가격 책정 - [ ] 다국어 지원 --- **마감일:** 2026-01-17 **공모전:** PlayMCP 공모전