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

Metadata

Release files for china-travel-mcp 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for china-travel-mcp 1.0.3
File Size Uploaded
china_travel_mcp-1.0.3.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for china-travel-mcp 1.0.3
File Interpreter ABI Platform
china_travel_mcp-1.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 11.3 kB

Release files / china_travel_mcp-1.0.3.tar.gz

Download URL china_travel_mcp-1.0.3.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0be45ac1299e0bc4a91355b1cfadd1f28162207cf12bda5886dde2b8779a4049
BLAKE2b-256 checksum
How to use checksums
79e106621495d6029a09724794782946c1f965673bff7c8fafa83b5985107825
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / china_travel_mcp-1.0.3-py3-none-any.whl

Download URL china_travel_mcp-1.0.3-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b844fffe218adb296a118dd461425d4f8854e7edf6b168b4e5433dc5bf99903c
BLAKE2b-256 checksum
How to use checksums
7d6fc0c0927df455dc98628cca050fcd57a6e0f46e267aa168fa1dbf53ed084a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

1.0.3 This release

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page