AI导哈

度假租赁管理API服务器

Hostaway MCP服务器是一个模型上下文协议服务器，提供对Hostaway API的访问，用于度假租赁管理，支持搜索物业、查看详情和访问定价信息。

  • by atlasvrm
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 atlasvrm/hostaway-mcp

使用说明

托管MCP服务器

一种模型上下文协议（MCP）服务器，提供对旅舍API的访问，用于度假租赁管理。此服务器允许Claude Desktop从您的Hostaway帐户搜索属性、查看详细信息和访问定价信息。

特性

  • 🔍 搜索财产 -查找具有广泛过滤选项的度假租赁
  • 🏠 查看物业详细信息 -获取有关特定房产的全面信息
  • 💰 定价设置 -接入信道特定定价和服务水平配置
  • 🛏️ 床型 -检索物业配置的床型映射

安装

Hostaway MCP服务器可以直接从GitHub安装：

选项1：使用npx直接执行（推荐）

无需安装-Claude Desktop将直接运行它：

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["github:atlasvrm/hostaway-mcp"],
      "env": {
        "HOSTAWAY_CLIENT_ID": "your-id",
        "HOSTAWAY_CLIENT_SECRET": "your-secret"
      }
    }
  }
}

选项2：全局安装

npm install -g github:atlasvrm/hostaway-mcp

然后在Claude Desktop中使用：

{
  "mcpServers": {
    "hostaway": {
      "command": "hostaway-mcp",
      "args": [],
      "env": {
        "HOSTAWAY_CLIENT_ID": "your-id",
        "HOSTAWAY_CLIENT_SECRET": "your-secret"
      }
    }
  }
}

配置

1.获取您的Hostaway API凭据

  1. 登录到您的 Hostaway 账户
  2. 导航到“设置”→ API
  3. 注意你的：
    • 客户端ID （例如，“12345”）
    • 客户端密钥 （例如，“abcdef123456…”）

2.配置克劳德桌面

将安装部分的配置添加到Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
Linux： ~/.config/claude/claude_desktop_config.json

⚠️ 重要：替换 "your-id" 和 "your-secret" 使用步骤1中的实际Hostaway API凭据。

3.重新启动克劳德桌面

完全退出并重新启动Claude Desktop以使配置生效。

可用工具

搜索列表

搜索具有广泛过滤选项的房产：

  • limit -最大结果数
  • offset -要跳过的结果数
  • city -按城市名称筛选
  • country -按国家代码筛选
  • match -按房源名称搜索
  • sortOrder -按各种标准对结果进行排序
  • availabilityDateStart / availabilityDateEnd -查看可用日期
  • availabilityGuestNumber -按客人容量筛选
  • 还有更多的过滤器。..

获取列表详细信息

获取有关特定列表的全面信息：

  • listingId -物业ID（必填）

获取定价设置

获取定价设置和特定渠道的配置：

  • listingId -物业ID（必填）

获取床型

获取所有可用的床型以进行酒店配置。

使用示例

配置后，您可以询问Claude：

  • “搜索迈阿密的房产”
  • “显示属性ID 12345的详细信息”
  • “12345房产的定价设置是什么？”
  • “列出所有可用的床型”

令牌缓存

服务器在本地缓存身份验证令牌 ~/.hostaway-mcp/token-cache.json 以避免不必要的API调用。令牌过期时会自动刷新。

发展

地方发展

# Clone the repository
git clone https://github.com/atlasvrm/hostaway-mcp.git
cd hostaway-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

建筑

npm run build

测试

创建一个 .env 使用您的凭据文件：

HOSTAWAY_CLIENT_ID=your_client_id
HOSTAWAY_CLIENT_SECRET=your_client_secret

然后运行测试脚本：

npm run test:api

故障排除

“身份验证失败”错误

  • 验证您的客户端ID和客户端密码是否正确
  • 检查您的Hostaway API访问是否处于活动状态

“未找到属性”错误

  • 确保您的Hostaway帐户中存在该物业ID
  • 验证您是否有权访问该物业

服务器未出现在Claude中

  • 确保配置后重新启动了Claude Desktop
  • 检查npx是否在系统PATH中
  • 验证配置文件是否为有效的JSON

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

内置于❤️ 通过阿特拉斯度假租赁

相关 MCP