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（空档期折扣）。包含每晚明细。	是
`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`	每季节、房客等级和日期类型的每晚费率总和
联邦 / 直接预订	`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 工具

代理商业协议 (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
README 针对 AI 解析进行了优化，包含结构化元数据
代码注释中包含全面的工具描述（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