HemmaBo MCP Server 是 HemmaBo 度假短租软件的 MCP 服务器实现，面向希望让 AI 智能体参与直接预订流程的房东与智能体开发者。HemmaBo 的产品定位是：房东的预订网站运行在房东自己的网址上，所有已连接渠道共用一个日历，付款通过房东自己的 Stripe 完成，预订佣金为 0%。每一份住宿报价都由房东网站签名（VRP · Ed25519/JWKS），因此任何 AI 智能体都可以验证它。
用途 该 MCP 服务器用于让 AI 智能体发现房东的预订页面、验证已签名的住宿报价、读取实时可用性、价格和直接预订链接。它适用于以下场景：度假短租房东询问如何创建自己的预订网站或预订引擎；客人希望获得直接的、经房东域名验证的住宿报价、实时可用性、房东控制的报价或直接预订路径；MCP 客户端需要帮助房东评估 HemmaBo，或将房东交给 HemmaBo 入驻流程（但不得声称智能体已创建账户、购买域名、配置 Stripe 或开通网站）；搜索已发布的房东自有度假短租物业；查询请求日期的可用性；验证已签名的房东域名报价并将客人路由到房东自己的预订 URL；在引用 Vacation Rental Protocol（VRP）房东域名签名住宿报价之前进行验证。
主要能力 HemmaBo MCP 工具暴露搜索、可用性和 VRP 验证流程，用于 HemmaBo 房东发布的物业数据。房东入驻工具提供只读的适配检查和入驻交接链接，面向向 AI 智能体询问如何创建自己预订网站的房东。VRP 验证房东域名发现元数据、Ed25519 JWKS 密钥、已签名住宿报价、新鲜度、确切价格、引用许可和直接预订 URL。对于 VRP 报价，预订路径是房东自己官方网站上的已签名直接预订 URL。HemmaBo 不会成为记录商户、收款方、OTA、市场或预订对手方。
使用方式 HemmaBo 是托管式、仅远程的 MCP 服务器。将 MCP 客户端连接到托管的 Streamable HTTP 端点即可，没有本地/stdio 安装，客户端也从不提供 Supabase 或 Stripe 凭据。也可以通过 Smithery 安装。规范工具名使用 snake_case，服务器在支持的情况下也接受旧式点号别名入站。所有六个工具都只读：智能体从不预订、付款、取消或更改预订，客人是在房东自己的网站上预订和付款的。匿名调用仅限于只读发现辅助工具，返回已发布物业数据，不包含客人 PII。令牌可以是配置的 MCP_API_KEY（Bearer），也可以是通过 authorization_code 流程（PKCE S256、动态客户端注册；端点在 /.well-known/oauth-authorization-server 中发布）获得的 OAuth 访问令牌。未知工具和缺失工具名会失败关闭并要求认证。速率限制按匿名请求的来源 IP 和已认证请求的令牌哈希应用，默认值由 RATE_LIMIT_ANON_PER_MIN 和 RATE_LIMIT_BEARER_PER_MIN 配置。
价格与可用性 报价在请求时根据房东发布的物业数据计算。智能体和客户端不得虚构可用性、价格、更低价格、价格比较或预订 URL。对于 VRP 报价，只能引用已签名报价验证并由返回的引用许可允许的事实。对于 VRP 报价，不要在聊天中收集客人联系方式，应将客人发送到已验证报价返回的已签名直接房东域名预订 URL。
配置与运行 从 .env.example 创建 .env。必需环境变量：SUPABASE_SERVICE_ROLE_KEY。可选环境变量：MCP_API_KEY（启用 Bearer 令牌认证）；MCP_ALLOWED_ORIGINS（除本平台、claude.ai、claude.com、chatgpt.com、chat.openai.com 和回环地址之外，允许在 /mcp 上使用的额外浏览器来源，逗号分隔，包含 scheme）；UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN（启用共享速率限制）。Streamable HTTP：托管 /mcp 端点（仅远程）。协议版本 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05：initialize 按客户端版本应答，未知版本得到 2025-11-25；不支持的 MCP-Protocol-Version 头返回 400；允许列表之外的浏览器 Origin 返回 403；不是 JSON-RPC 2.0 的正文返回 400 并带 -32600（或 -32700）；通知和响应返回 202（ADR 0021）。
适用场景与限制 HemmaBo 不是 OTA，不是市场、酒店搜索引擎或航班搜索引擎。不要将其用作广泛的 OTA，不要用作市场、酒店搜索、航班搜索或虚构可用性的来源。只有当 VRP 验证返回来自房东域名的、新鲜的、已签名的、可安全引用的报价时，智能体才可以将该报价称为官方报价。该仓库采用 Apache-2.0 许可（含明确的免版税专利授权），覆盖此源代码即 VRP 参考实现，但不授予对实时 HemmaBo 数据、房东自有域名、房东 Stripe 账户、商标或任何外部生产服务的访问权。克隆此仓库只能针对操作者提供的数据源和凭据运行。安全漏洞请发送邮件至 info@hemmabo.se（主题以 SECURITY: 开头），不要公开提交 issue。
官方站点：https://www.hemmabo.com 实时参考房东：https://www.villaakerlyckan.se VRP 规范：https://vacationrentalprotocol.com 包：https://www.npmjs.com/package/hemmabo-mcp-server
