serpapi-hotels

SerpAPI Hotels MCP 服务

一个通过 SerpAPI API 搜索 Google Hotels 的 MCP 服务。按日期范围搜索任意地区的酒店，并获取价格、评分、评价和预订信息。

工具

工具	描述
search_hotels	使用价格、评分、星级、设施等筛选条件搜索酒店
get_hotel_details	获取特定酒店的详细信息，包括评价分类统计以及来自多个来源的预订价格
get_hotel_reviews	获取住客的单条评价，包括完整文本、评分、细分评分和酒店管理方回复

快速开始

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "serpapi-hotels": {
      "command": "npx",
      "args": ["-y", "serpapi-hotels-mcp-server"],
      "env": {
        "SERPAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

手动设置

# Clone and install
cd experimental/serpapi-hotels
npm run install-all

# Set your API key
export SERPAPI_API_KEY=your_api_key_here

# Build and run
npm run build
cd local && npm start

配置

变量	必填	描述
SERPAPI_API_KEY	是	你的 SerpAPI API 密钥（在此获取）

使用示例

搜索酒店

Search for hotels in New York for March 1-5, 2026, sorted by lowest price

search_hotels 工具将使用以下参数调用：

• query：“纽约的酒店”
• check_in_date：“2026-03-01”
• check_out_date：“2026-03-05”
• sort_by：3

获取酒店详情

找到酒店后，使用其 property_token 调用 get_hotel_details，即可获取：

• 来自多个预订来源的价格（Booking.com、Hotels.com、Expedia 等）
• 按类别划分的评价统计（清洁度、位置、服务）
• 完整的设施列表
• 入住/退房时间
• 附近地点及行程时间

查看酒店评价

找到酒店后，使用其 property_token 调用 get_hotel_reviews，即可获取：

• 来自 Google 和第三方来源（TripAdvisor 等）的完整评价文本
• 评价者评分及细分评分（客房、服务、位置）
• 酒店管理方回复
• 按最有帮助、最新、评分最高/最低排序
• 按类别筛选（来自 get_hotel_details 的评价分类统计）

可用筛选条件

筛选条件	值
sort_by	3 = 价格最低，8 = 评分最高，13 = 评价最多
rating	7 = 3.5+，8 = 4.0+，9 = 4.5+
hotel_class	“2”、“3”、“4”、“5”（星级，逗号分隔）
min_price / max_price	每晚价格范围
free_cancellation	true/false
special_offers	true/false
eco_certified	true/false
vacation_rentals	true = 改为搜索度假租赁住宿

开发

npm run install-all    # Install all dependencies
npm run build          # Build the project
npm run dev            # Development mode
npm test               # Run functional tests
npm run test:integration  # Run integration tests
npm run test:manual    # Run manual tests (requires API key)

项目结构

serpapi-hotels/
├── local/              # Stdio transport entry point
│   └── src/
│       ├── index.ts                      # Main entry point
│       └── index.integration-with-mock.ts # Mock entry for integration tests
├── shared/             # Core business logic
│   └── src/
│       ├── server.ts         # MCP server factory
│       ├── tools.ts          # Tool registration
│       ├── resources.ts      # Resource handlers
│       ├── types.ts          # TypeScript types
│       ├── logging.ts        # Logging utilities
│       ├── tools/            # Individual tool implementations
│       │   ├── search-hotels.ts
│       │   ├── get-hotel-details.ts
│       │   └── get-hotel-reviews.ts
│       └── serpapi-client/   # SerpAPI client
│           ├── serpapi-client.integration-mock.ts
│           └── lib/
│               ├── parse-property.ts
│               ├── search-hotels.ts
│               ├── get-hotel-details.ts
│               └── get-hotel-reviews.ts
└── tests/
    ├── functional/       # Unit tests with mocks
    ├── integration/      # Full MCP protocol tests
    ├── manual/           # Real API tests
    └── mocks/            # Mock implementations