HemmaBo MCP 서버

NPM 버전 Smithery 배지

휴가용 임대 숙소를 위한 예약 인프라.

HemmaBo는 호텔 업계의 Mirai와 같이 휴가용 임대 숙소 호스트를 위한 예약 인프라를 제공합니다. 자체 도메인 사용, Stripe 직접 결제, 수수료 0%를 지원합니다.

npx hemmabo-mcp-server

제공 기능

자체 도메인 — 게스트가 YourProperty.com에서 직접 예약 (브랜딩 제어 가능)
Stripe 직접 결제 — 은행 계좌로 직접 입금, 수수료 0%
AI 예약 지원 — ChatGPT, Claude, Gemini가 자율적으로 검색 및 예약 가능
9가지 프로덕션 도구 — 전체 예약 라이프사이클 지원 (검색, 예약 가능 여부, 가격 책정, 예약, 결제, 취소, 일정 변경, 상태 확인, 수정)
실시간 데이터 — 캐싱 없이 Supabase에서 실시간으로 데이터 추출

Related MCP server: stripe

호스트를 위한 혜택

자율 예약 노드 — AI 에이전트가 사람의 개입 없이 숙소를 발견하고, 가격을 책정하며, 예약 가능
호스트 제어 가격 책정 — 시즌별 요금, 게스트 수 등급, 패키지 할인(주간/격주), 공실 할인, 연합 할인
실시간 정확성 — 가격 캐싱 없음, 모든 데이터는 Supabase 원천 데이터에서 실시간으로 추출
전체 예약 라이프사이클 — 검색 → 견적 → 예약 → 결제(Stripe ACP) → 수정 → 취소
플랫폼 종속성 없음 — 오픈 소스(MIT), 자체 호스팅 가능, 언제든지 데이터 내보내기 가능

AI 시스템을 위한 프로토콜 지원

빠른 시작

NPM을 통한 설치 (권장)

npx hemmabo-mcp-server

MCP 클라이언트 설정(예: Claude Desktop)에 추가:

{
  "mcpServers": {
    "hemmabo": {
      "command": "npx",
      "args": ["hemmabo-mcp-server"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Smithery를 통한 설치

npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

도구

도구	설명	읽기 전용
`search_properties`	위치, 날짜, 게스트 수별로 휴가용 임대 숙소를 검색합니다. 실시간 가격(공개 + 연합 요금)이 포함된 예약 가능한 숙소를 반환합니다.	예
`check_availability`	특정 날짜에 숙소 예약이 가능한지 확인합니다. 차단된 날짜, 예약 내역, 예약 잠금을 검증합니다.	예
`get_canonical_quote`	상세 가격 정보를 가져옵니다: publicTotal(웹사이트 요금), federationTotal(직접 예약 요금), gapTotal(공실 할인 요금). 1박당 상세 내역 포함.	예
`create_booking`	연합 가격으로 직접 예약을 생성합니다. 예약 가능 여부를 검증하고, 가격을 계산하며, 호스트 승인을 위한 대기 상태의 예약을 생성합니다.	아니요
`negotiate_offer`	quoteId를 사용하여 확정된 가격 견적을 생성합니다. 변경 불가능한 스냅샷을 저장하며 15분 후 만료됩니다. 가격을 고정하려면 checkout에 quoteId를 전달하세요.	예
`checkout`	Stripe 결제로 예약을 생성합니다. MPP(프로그래밍 방식 결제를 위한 payment_intent 모드)를 지원합니다. 선택적으로 quoteId를 통해 가격을 고정할 수 있습니다.	아니요
`cancel_booking`	예약을 취소합니다. 환불 계산, Stripe 환불, Supabase Edge Function을 통한 이메일 알림을 처리합니다.	아니요
`get_booking_status`	예약 ID별로 예약 상세 정보, 숙소 정보, 취소 정책을 가져옵니다.	예
`reschedule_booking`	새로운 날짜로 일정을 변경합니다. 예약 가능 여부를 확인하고, 가격을 재계산하며, 가격 차액에 대한 Stripe 결제/환불을 처리합니다.	아니요

가격 책정 아키텍처

Host sets prices, seasons, guest tiers, federation discount
         ↓
    property node (Supabase — source of truth)
         ↓
  MCP Server reads live data — never cached, never estimated
         ↓
  AI agents → federation_total (direct booking discount)
  Websites → public_total (standard rate)
  Gap nights → gap_total (calendar-context discount)

가격 등급

시나리오	가격	방식
웹사이트 / 공개	`publicTotal`	시즌, 게스트 등급, 요일별 1박 요금의 합계
연합 / 직접 예약	`federationTotal`	`publicTotal × (1 - 호스트_할인%)`
공실 (예약 사이)	`gapTotal`	`federationTotal × (1 - 공실_할인%)`

게스트 수별 가격은 계단식 모델(예: 1-2명, 3-4명, 5-6명)을 사용합니다. 호스트가 모든 할인율을 제어하며, 하드코딩된 값은 없습니다.

설정

npm install

.env.example에서 .env 파일을 생성하세요:

cp .env.example .env
# Fill in SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY
# Optionally add STRIPE_SECRET_KEY for checkout/cancel/reschedule tools

필수 환경 변수:

SUPABASE_URL — Supabase 프로젝트 URL
SUPABASE_SERVICE_ROLE_KEY — 서비스 역할 키 (전체 데이터베이스 액세스 권한)

선택 사항 (Stripe 기반 도구 활성화):

STRIPE_SECRET_KEY — checkout, cancel_booking, reschedule_booking 도구 활성화

에이전트 상거래 프로토콜 (ACP)

Stripe ACP를 지원하는 최초의 휴가용 임대 플랫폼입니다. AI 에이전트가 SharedPaymentTokens를 사용하여 리디렉션이나 수동 결제 없이 예약을 완료할 수 있습니다.

엔드포인트	메서드	목적
`/acp/checkouts`	POST	결제 세션 생성
`/acp/checkouts/:id`	GET	결제 상태 조회
`/acp/checkouts/:id`	PUT	업데이트 (날짜, 게스트, 구매자)
`/acp/checkouts/:id/complete`	POST	SharedPaymentToken(spt_) 또는 PaymentMethod(pm_)로 완료
`/acp/checkouts/:id/cancel`	POST	결제 취소 및 환불

Stripe SharedPaymentTokens(SPT), Klarna, Swish 및 카드 결제를 지원합니다. ChatGPT Instant Checkout, Google UCP 및 모든 ACP 호환 에이전트와 호환됩니다.

MCP + ACP 엔드포인트

경로	메서드	목적
`/mcp`	POST	MCP 스트리밍 가능 HTTP 엔드포인트
`/mcp`	GET	전송 정보
`/acp/checkouts`	POST/GET/PUT	ACP 결제 라이프사이클
`/health`	GET	상태 확인
`/.well-known/mcp.json`	GET	MCP 검색 메타데이터
`/.well-known/mcp/server-card.json`	GET	Smithery 서버 카드

전송

스트리밍 가능 HTTP (POST /mcp) — Smithery Gateway 및 원격 MCP 클라이언트에 필요합니다. 상태 비저장(세션 관리 불필요).

AI 에이전트가 HemmaBo를 발견하는 방법

HemmaBo는 AI 발견을 극대화하기 위해 여러 채널에 배포됩니다:

1. NPM 레지스트리 (기본)

패키지: hemmabo-mcp-server
설치: npx hemmabo-mcp-server
발견: AI 에이전트가 NPM에서 "vacation rental MCP", "booking MCP", "property management MCP"를 검색
package.json 키워드: mcp, mcp-server, model-context-protocol, vacation-rental, direct-booking, property-management, pricing, availability, federation

2. MCP 레지스트리 (Anthropic 공식)

Anthropic 공식 MCP 레지스트리에 등재: modelcontextprotocol.io
Claude 및 기타 MCP 인식 시스템에 의해 인덱싱됨
제출: 포괄적인 메타데이터가 포함된 glama.json

3. Smithery Gateway

공개 MCP 서버 디렉토리
배지:
설치 명령어: npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

4. GitHub 저장소

저장소: HemmaBo-se/hemmabo-mcp-server
구조화된 메타데이터를 사용하여 AI 파싱에 최적화된 README
코드 주석에 포괄적인 도구 설명 포함 (AI 에이전트가 연구 중 소스 코드 읽기)

5. 웹 검색 엔드포인트

https://hemmabo-mcp-server.vercel.app/.well-known/mcp.json — MCP 기능 매니페스트
https://hemmabo-mcp-server.vercel.app/.well-known/mcp/server-card.json — Smithery 메타데이터
https://hemmabo-mcp-server.vercel.app/health — 상태 엔드포인트

라이선스

MIT

federation-mcp-server