enhanced-airbnb-mcp 仓库详细介绍

项目概述

核心功能

• 更好的错误处理：通过提供详细的错误信息和更为可靠的异常处理机制，显著提升了错误检查和排除的效率。
• 增强的日志记录：更完备的日志记录机制，便于开发人员进行调试和监控。
• 类型安全：利用 TypeScript 更好地定义数据类型，减少意外错误。
• 代码组织优化：模块化的代码结构，使得项目更易于维护和扩展。
• 性能优化：优化网络请求及响应处理，加快数据传输速度。
• 丰富的结果信息：提供更为详细的房源信息及元数据。
• 遵循 robots.txt：默认情况下尊重 Airbnb 的 robots.txt 规则，同时提供了忽略选项以供灵活使用。

可用工具

为了更好地利用此服务，项目提供了以下两个主要功能接口：

1. airbnb_search

用于搜索 Airbnb 平台上的房源信息。

• 必需输入：location（字符串）用以指定搜索位置。
• 可选输入：
  • placeId（字符串）：Google Maps 地标ID。
  • checkin 和 checkout（字符串，格式：YYYY-MM-DD）：入住和退房日期。
  • adults、children、infants、pets（数值）：指定入住人数及宠物。
  • minPrice 和 maxPrice（数值）：价格过滤。
  • cursor（字符串）：分页游标。
  • ignoreRobotsText（布尔值）：是否忽略 robots.txt 限制。
• 返回结果：包括房源名称、价格、位置等详细信息的房源列表。

2. airbnb_listing_details

用于获取特定 Airbnb 房源的详细信息。

• 必需输入：id（字符串）用以指定房源ID。
• 可选输入：
  • checkin 和 checkout（字符串，格式：YYYY-MM-DD）：入住和退房日期。
  • adults、children、infants、pets（数值）：指定入住人数及宠物。
  • ignoreRobotsText（布尔值）：是否忽略 robots.txt 限制。
• 返回结果：包括房源描述、位置、设施、政策等详细信息。

设置指南

在 Claude Desktop 上安装

1. 进入路径：Settings > Developer > Edit Config
2. 将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb"
      ]
    }
  }
}

如果想要对所有请求忽略 robots.txt，使用以下配置：

{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb",
        "--ignore-robots-txt"
      ]
    }
  }
}

1. 重新启动 Claude Desktop 即可开始规划您的 Airbnb 之旅。

使用 Smithery 安装

npx -y @smithery/cli install @openbnb-org/mcp-server-airbnb --client claude

示例使用

搜索房源示例

airbnb_search({"location": "Paris, France", "checkin": "2025-05-01", "checkout": "2025-05-07", "adults": 2})

获取房源详细信息示例

airbnb_listing_details({"id": "12345678", "checkin": "2025-05-01", "checkout": "2025-05-07", "adults": 2})

开发指南

从源码构建

如果您希望从源码开始构建本项目，请按以下步骤操作：

git clone https://github.com/your-repo/mcp-server-airbnb.git
cd mcp-server-airbnb
npm install
npm run build

本地运行

您可以通过以下命令在本地启动服务：

npm start
# 或者，如需忽略 robots.txt
npm run start:ignore-robots

授权许可

本 MCP 服务器依据 MIT 许可证进行授权。

免责声明

Airbnb 是 Airbnb, Inc. 的商标。OpenBnB 不隶属于 Airbnb, Inc. 或其子公司。