China Travel Mcp

Created By
mako2026055 days ago
Overview

China Travel MCP

PyPI version License: MIT

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

Server Config

{
  "mcpServers": {
    "china-travel": {
      "command": "uvx",
      "args": [
        "china-travel-mcp"
      ]
    }
  }
}
Project Info
Created At
5 days ago
Updated At
5 days ago
Author Name
mako202605
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All
Tavily Mcp
@tavily-ai

JavaScript
a year ago