项目介绍
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]
