Skip to main content

China Travel MCP

PyPI version License: MIT

The most comprehensive MCP server for China inbound travel, powered by Trip.com — the world's #1 travel platform for visiting China. Real-time hotel pricing, flight search, attraction tickets, itinerary planning, and travel tips with one-click booking.

✈️ Official Trip.com Affiliate Partner — All search results include live pricing and direct booking links from Trip.com, supporting Visa/Mastercard/international payment.

Features

  • 🏨 Search Hotels — Find hotels across China with real-time pricing and Trip.com booking links
  • ✈️ Search Flights — Query domestic and international flights to/from China
  • 🎫 Search Attractions — Discover top attractions, ticket prices, and opening hours
  • 📋 Plan Itinerary — Generate complete multi-day travel itineraries
  • 💡 Travel Tips — Get practical advice on visa, transportation, payment, safety, and culture

Quick Start

Installation

pip install china-travel-mcp

Run as Standalone Server

china-travel-mcp

Configure in Claude Desktop / Cursor

Add to your MCP client configuration:

{
  "mcpServers": {
    "china-travel": {
      "command": "uvx",
      "args": ["china-travel-mcp"]
    }
  }
}

Build from Source

git clone https://github.com/mako2026/china-travel-mcp.git
cd china-travel-mcp
pip install -e .

Tools

search_hotels

Search hotels in any Chinese city with pricing and booking links.

Parameters:

  • city (required) — City name, e.g. "Beijing", "Shanghai", "Xi'an"
  • check_in — Check-in date (YYYY-MM-DD)
  • check_out — Check-out date (YYYY-MM-DD)
  • guests — Number of guests (default: 2)
  • budget — Budget level, e.g. "budget", "mid-range", "luxury"
  • preferences — Preferences, e.g. "near city center", "with breakfast"

search_flights

Search flights to, from, or within China.

Parameters:

  • origin (required) — Departure city, e.g. "Tokyo", "New York"
  • destination (required) — Arrival city, e.g. "Shanghai", "Beijing"
  • date (required) — Travel date (YYYY-MM-DD)
  • trip_type — "one way" or "round trip" (default: "one way")
  • cabin — "economy", "business", or "first" (default: "economy")

search_attractions

Discover top attractions and things to do in Chinese cities.

Parameters:

  • city (required) — City name, e.g. "Beijing", "Guilin", "Hangzhou"
  • days — Number of sightseeing days (default: 1)
  • interests — Interests, e.g. "history", "nature", "food", "photography"

plan_itinerary

Generate a complete multi-day travel itinerary.

Parameters:

  • city (required) — City name
  • days (required) — Number of days
  • travelers — Number of travelers (default: 2)
  • interests — Travel interests
  • budget — Budget level

get_travel_tips

Get practical travel advice for China.

Parameters:

  • question (required) — Your travel question in natural language

Examples

Ask your AI assistant:

  • "Find me a hotel in Shanghai near the Bund for 3 nights"
  • "What flights are available from Tokyo to Beijing next Friday?"
  • "What are the must-visit attractions in Xi'an?"
  • "Plan a 5-day trip to Chengdu for a couple interested in food and pandas"
  • "Do I need a visa to visit China? What about the 144-hour transit visa?"

Supported Languages

The server defaults to English responses. The underlying API also supports: Chinese (zh), Japanese (ja), Korean (ko), Russian (ru), Spanish (es), French (fr), German (de), Arabic (ar), Thai (th), Vietnamese (vi).

Data Source

This MCP server is built by an Official Trip.com Affiliate Partner (Alliance ID: 8405769). All hotel, flight, and attraction data is sourced directly from Trip.com's real-time inventory via the TripGenie API.

Trip.com is the international brand of Trip.com Group (NASDAQ: TCOM / 9961.HK), the world's leading online travel agency. With 1.4M+ hotels, 5,000+ city flight coverage, and 24/7 multilingual support, Trip.com is the most trusted booking platform for travelers visiting China.

All booking links in search results are direct Trip.com links with affiliate tracking, ensuring travelers get the best available prices while supporting the continued development of this MCP server.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

china_travel_mcp-1.0.3.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

china_travel_mcp-1.0.3-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

Details for the file china_travel_mcp-1.0.3.tar.gz.

File metadata

  • Download URL: china_travel_mcp-1.0.3.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for china_travel_mcp-1.0.3.tar.gz
Algorithm Hash digest
SHA256 0be45ac1299e0bc4a91355b1cfadd1f28162207cf12bda5886dde2b8779a4049
MD5 cab2cbbc3432849f54b82b246223b0ac
BLAKE2b-256 79e106621495d6029a09724794782946c1f965673bff7c8fafa83b5985107825

See more details on using hashes here.

File details

Details for the file china_travel_mcp-1.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for china_travel_mcp-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b844fffe218adb296a118dd461425d4f8854e7edf6b168b4e5433dc5bf99903c
MD5 ecdf260ba3b63db97c4de61e2231539d
BLAKE2b-256 7d6fc0c0927df455dc98628cca050fcd57a6e0f46e267aa168fa1dbf53ed084a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page