hostaway-mcp

MCP-сервер для Hostaway, ориентированный на сферу гостеприимства, с доступом только для чтения.

Этот репозиторий содержит только продукт оператора: локальный/npm stdio, шесть инструментов с доступом только для чтения, без Cloudflare Worker и без интерфейса бронирования Seascape.

Цель V1

Сделать Codex и Claude полезными в реальных рабочих процессах Hostaway без необходимости каждый раз вручную прописывать необработанные вызовы API.

Версия V1 намеренно ограничена:

• только чтение

• инструменты, адаптированные для сферы гостеприимства, а не простое соответствие конечным точкам API

• оптимизировано для контекста переписки, поиска бронирований и поиска объектов размещения

Related MCP server: guesty-mcp-server

Точная поверхность V1

• list_unread_guest_threads

• get_conversation_context

• get_reservation_brief

• get_listing_brief

• search_reservations

• search_conversations

Локальная разработка

npm install
npm test
npm run check
npm run build

Запустите stdio-сервер локально:

HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js

Создайте локальный tar-архив npm-пакета:

npm pack

После публикации запустите без клонирования:

npx hostaway-mcp

Настройка MCP-клиента

Для локальных MCP-клиентов передайте HOSTAWAY_API_TOKEN через переменные окружения и запустите опубликованный npm-пакет через stdio.

Приведенные ниже фрагменты кода привязаны к текущей опубликованной версии:

hostaway-mcp@0.2.0

Обновляйте эту версию намеренно при обновлении.

Claude Desktop (macOS)

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json.

Если у вас уже есть ключи верхнего уровня, такие как preferences, сохраните их и добавьте mcpServers рядом с ними:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения файла.

Codex

Отредактируйте ~/.codex/config.toml и добавьте:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

Проверьте, что сервер зарегистрирован:

codex mcp list

Локальный собранный CLI

Если вы хотите запустить проверку репозитория вместо npm, укажите клиенту путь напрямую к собранному CLI:

{
  "command": "node",
  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
  "env": {
    "HOSTAWAY_API_TOKEN": "your-token-here"
  }
}

Переменные окружения

Не входит в цели V1

• отправка сообщений гостям

• изменение бронирований или объектов размещения

• транспорт Cloudflare Worker

• потоки бронирования/дистрибуции Seascape

• получение вебхуков

• фоновые конвейеры синхронизации

• панели мониторинга или отчетность для владельцев

• общее покрытие прокси-сервера REST-to-MCP

Проектирование исходного кода

См. docs/designs/v1-readonly-hostaway-mcp.md.