Hostaway

io.github.uncfreak1255-code由 GitHub 账号 uncfreak1255-code 发布v0.2.0更新于 Oct 24, 2026

Read-only MCP server for Hostaway PMS — guest conversations, reservations, and listings

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

面向 Hostaway 物业管理的只读 MCP 服务器，可查询房客对话、预订和房源。

可以做什么
通过 Hostaway PMS API 提供六个只读工具：list_unread_guest_threads、get_conversation_context、get_reservation_brief、get_listing_brief、search_reservations 和 search_conversations。它面向酒店业务场景，而非原始接口的简单代理，重点在于对话上下文、预订查询和房源查询。它不会发送房客消息，也不会修改预订或房源。
适用场景
当助手需要查询 Hostaway 的预订、房源或房客对话上下文，而不想每次手动调用原始 API 时使用。适合只读的分诊和查询流程，不适合发送消息或修改数据。
运行要求
通过 stdio 在本地运行，通常使用 npx hostaway-mcp 或已构建的 CLI。需要 Node.js，并通过环境变量 HOSTAWAY_API_TOKEN 提供 Hostaway API 令牌。可选的环境变量 HOSTAWAY_BASE_URL 可覆盖 API 基础地址。需要访问 Hostaway API 的网络连接。
安装前请注意
该服务器需要 HOSTAWAY_API_TOKEN 密钥，可访问 Hostaway 账户数据；请勿将其写入共享配置文件或提交到版本控制。它按设计为只读，不会发送消息或修改预订、房源，但读取的数据会发送给助手及其模型提供商。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hostaway，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

hostaway-mcp

Read-only, hospitality-shaped MCP server for Hostaway.

This repo owns the operator product only: local/npm stdio, six read-only tools, no Cloudflare Worker, and no Seascape booking surface.

V1 Goal

Make Codex and Claude useful in real Hostaway workflows without hand-wiring raw API calls every time.

V1 is intentionally narrow:

  • read-only only
  • hospitality-native tools, not raw endpoint parity
  • optimized for conversation context, reservation lookup, and listing lookup

Exact V1 Surface

  • list_unread_guest_threads
  • get_conversation_context
  • get_reservation_brief
  • get_listing_brief
  • search_reservations
  • search_conversations

Local Development

bash
npm installnpm testnpm run checknpm run build

Run the stdio server locally:

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

Create a local npm package tarball:

bash
npm pack

After publish, run without cloning:

bash
npx hostaway-mcp

MCP Client Wiring

For local MCP clients, provide HOSTAWAY_API_TOKEN through the environment and spawn the published npm package over stdio.

The snippets below are pinned to the current published version:

text
[email protected]

Update that version intentionally when you upgrade.

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json.

If you already have top-level keys like preferences, keep them and add mcpServers alongside them:

json
{  "mcpServers": {    "hostaway": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "HOSTAWAY_API_TOKEN": "your-token-here"      }    }  }}

Restart Claude Desktop after saving the file.

Codex

Edit ~/.codex/config.toml and add:

toml
[mcp_servers.hostaway]command = "npx"args = ["-y", "[email protected]"]
[mcp_servers.hostaway.env]HOSTAWAY_API_TOKEN = "your-token-here"

Verify the server is registered:

bash
codex mcp list

Local Built CLI

If you want to run the repo checkout instead of npm, point the client at the built CLI directly:

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

Environment Variables

VariableRequiredDefaultDescription
HOSTAWAY_API_TOKENYes—Hostaway API token used to authenticate all requests.
HOSTAWAY_BASE_URLNoHostaway production URLOverride the API base URL (useful for testing).

V1 Non-Goals

  • sending guest messages
  • mutating reservations or listings
  • Cloudflare Worker transport
  • Seascape booking/distribution flows
  • webhook ingestion
  • background sync pipelines
  • dashboards or owner reporting
  • generic REST-to-MCP proxy coverage

Source Design

See docs/designs/v1-readonly-hostaway-mcp.md.

来源：README.md，提交 7708f14

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分