china-travel-mcp 1.0.0

China inbound travel MCP server - search hotels, flights, attractions, plan itineraries, and get travel tips for China

China Travel MCP

An MCP (Model Context Protocol) server that provides AI assistants with comprehensive China inbound travel capabilities. Powered by TripGenie API with Trip.com affiliate booking links.

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

Powered by Trip.com — the world's leading online travel platform. All booking links include affiliate tracking.

License

MIT