hostaway-mcp

面向 Hostaway 的只读、酒店业专用 MCP 服务器。

本仓库仅包含操作员产品：本地/npm stdio，六个只读工具，不包含 Cloudflare Worker，也不包含 Seascape 预订界面。

V1 目标

让 Codex 和 Claude 在实际的 Hostaway 工作流程中变得有用，而无需每次都手动编写原始 API 调用。

V1 的范围特意缩小：

• 仅限只读

• 酒店业原生工具，而非原始端点对等

• 针对对话上下文、预订查询和房源查询进行了优化

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

创建本地 npm 包压缩包：

npm pack

发布后，无需克隆即可运行：

npx hostaway-mcp

MCP 客户端配置

对于本地 MCP 客户端，通过环境变量提供 HOSTAWAY_API_TOKEN，并通过 stdio 生成已发布的 npm 包。

以下代码片段固定为当前发布的版本：

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 预订/分发流程

• Webhook 摄取

• 后台同步管道

• 仪表板或业主报告

• 通用 REST 转 MCP 代理覆盖

源代码设计

请参阅 docs/designs/v1-readonly-hostaway-mcp.md。