项目介绍

mcp-server-airbnb 是 openbnb-org 开源的 Airbnb 搜索 MCP 服务器,可让 Claude、Cursor 以及其他支持 Model Context Protocol 的 AI 客户端直接检索 Airbnb 房源,并获取具体房源的详细信息。

项目采用 Node.js 与 MCP stdio 传输方式,可在 Windows、macOS 和 Linux 上运行,适合旅行规划、住宿筛选、房源研究和 AI Agent 工具集成。

主要功能

  • 智能房源搜索:支持城市、州、地区和国际地点,可按入住/退房日期、成人、儿童、婴儿、宠物人数进行筛选。
  • 价格与房型过滤:支持最低/最高每晚价格,以及整套房源、独立房间、合住房间、酒店房间等类型。
  • 分页浏览:可通过游标继续获取更多搜索结果。
  • 房源详情:返回位置坐标、社区信息、设施、亮点、描述、入住规则、政策以及 Airbnb 原始页面链接。
  • 国际地点识别:默认通过 Photon,并在必要时使用 Nominatim 辅助地理编码,提高非美国地点的匹配准确度。

提供的 MCP 工具

airbnb_search

根据地点搜索 Airbnb 房源,可组合日期、人数、价格、房型、Place ID 与分页游标等参数。

airbnb_listing_details

根据 Airbnb 房源 ID 查询完整详情,并可附带入住日期与住客人数获取更符合行程的结果。

安装方法

Cursor 等 MCP 客户端

需要先安装 Node.js 18 或更高版本,然后在 MCP 配置文件中加入:

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

Claude Desktop

可前往 GitHub Releases 下载最新的 .mcpb 文件,打开文件后按照 Claude Desktop 的扩展安装提示完成配置。

使用说明

  • 默认遵守 Airbnb 的 robots.txt,并带有请求超时、输入校验和错误处理机制。
  • 如果不希望调用第三方地理编码服务,可设置 DISABLE_GEOCODING=true,或在请求中传入明确的 Google Maps Place ID。
  • 该项目只读取公开房源信息,不保存敏感数据;使用时仍应遵守 Airbnb 服务条款并控制请求频率。
  • 项目采用 MIT License,与 Airbnb, Inc. 没有关联。
公告: 本站资源均来源于网络,如有侵权,请联系 [email protected]