HemmaBo MCP Server

NPM Version Smithery Badge

Инфраструктура бронирования для аренды жилья.

HemmaBo для владельцев жилья — это то же самое, что Mirai для отелей: инфраструктура бронирования на вашем собственном домене, прямые платежи Stripe, 0% комиссии.

Посмотрите в действии: villaåkerlyckan.se

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 для фиксации цены.	Да
`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 из .env.example:

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 — URL вашего проекта Supabase
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	Потоковый HTTP-эндпоинт MCP
`/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)

Включен в официальный реестр MCP от Anthropic: 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. Веб-эндпоинты обнаружения

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