Serpapi Hotels

com.pulsemcp由 pulsemcp.com 發布v0.0.4更新於 Oct 24, 2026

MCP server for searching Google Hotels via SerpAPI — hotel search, pricing, ratings, and reviews.

已驗證STDIO僅桌面位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

透過 SerpAPI 搜尋 Google Hotels，讓助理尋找飯店、比較價格並閱讀旅客評價。

可以做什麼
  • 依地區與日期區間搜尋飯店，可依價格、評分、星級、設施、免費取消、優惠、環保認證或度假短租篩選
  • 取得指定飯店的詳細資訊，包括多個訂房來源的價格、評分細項、設施、入住時間與周邊地點
  • 讀取單則旅客評價，含全文、分項評分、飯店回覆，並支援排序與分類篩選
適用情境
適合旅遊規劃或住宿比較：助理可依日期查詢飯店、比較各訂房網站的價格與評分，並在決定訂房前彙整旅客意見。
執行需求
透過 npx 在本機執行（需 Node.js）。需要 SerpAPI 帳號與 API 金鑰，透過環境變數 SERPAPI_API_KEY 提供；需能連線至 SerpAPI。僅支援桌面用戶端。
安裝前請注意
SERPAPI_API_KEY 是付費服務的憑證，以明文環境變數傳入，請勿寫入共用設定。搜尋請求會送往 SerpAPI 與 Google Hotels，回傳的第三方訂房價格可能過時或因地區而異。此伺服器僅讀取資料，不會訂房或付款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Serpapi Hotels，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

SerpAPI Hotels MCP Server

An MCP server for searching Google Hotels via the SerpAPI API. Search for hotels in any area with date ranges, and get back prices, ratings, reviews, and booking information.

Tools

ToolDescription
search_hotelsSearch for hotels with filters for price, rating, star class, amenities, and more
get_hotel_detailsGet detailed info for a specific hotel including review breakdowns and booking prices from multiple sources
get_hotel_reviewsGet individual guest reviews with full text, ratings, sub-ratings, and hotel management responses

Quick Start

Claude Desktop

Add this to your Claude Desktop config file:

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

Manual Setup

bash
# Clone and installcd experimental/serpapi-hotelsnpm run install-all
# Set your API keyexport SERPAPI_API_KEY=your_api_key_here
# Build and runnpm run buildcd local && npm start

Configuration

VariableRequiredDescription
SERPAPI_API_KEYYesYour SerpAPI API key (get one here)

Example Usage

Search for hotels

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

The search_hotels tool will be called with:

  • query: "Hotels in New York"
  • check_in_date: "2026-03-01"
  • check_out_date: "2026-03-05"
  • sort_by: 3

Get hotel details

After finding a hotel, use get_hotel_details with its property_token to get:

  • Prices from multiple booking sources (Booking.com, Hotels.com, Expedia, etc.)
  • Review breakdown by category (cleanliness, location, service)
  • Full amenity list
  • Check-in/out times
  • Nearby places with travel times

Read hotel reviews

After finding a hotel, use get_hotel_reviews with its property_token to get:

  • Full review text from Google and third-party sources (TripAdvisor, etc.)
  • Reviewer ratings with sub-ratings (rooms, service, location)
  • Hotel management responses
  • Sorting by most helpful, most recent, highest/lowest score
  • Category filtering (from get_hotel_details review breakdown)

Available Filters

FilterValues
sort_by3 = lowest price, 8 = highest rating, 13 = most reviewed
rating7 = 3.5+, 8 = 4.0+, 9 = 4.5+
hotel_class"2", "3", "4", "5" (star rating, comma-separated)
min_price / max_pricePrice range per night
free_cancellationtrue/false
special_offerstrue/false
eco_certifiedtrue/false
vacation_rentalstrue = search vacation rentals instead

Development

bash
npm run install-all    # Install all dependenciesnpm run build          # Build the projectnpm run dev            # Development modenpm test               # Run functional testsnpm run test:integration  # Run integration testsnpm run test:manual    # Run manual tests (requires API key)

Project Structure

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

來源：experimental/serpapi-hotels/README.md，提交 0ed34de

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分