HemmaBo MCPサーバー

NPM Version Smithery Badge

バケーションレンタル向け予約インフラ。

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分後に期限切れとなります。価格を固定するには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 - host_discount%)`
ギャップナイト（予約間）	`gapTotal`	`federationTotal × (1 - gap_discount%)`

ゲスト人数別の価格設定は階段モデル（例：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 ツールを有効化

Agentic Commerce Protocol (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. Web検出エンドポイント

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