mcp-train-ticket 1.0.0__tar.gz

mcp_train_ticket-1.0.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: mcp-train-ticket
+Version: 1.0.0
+Summary: 12306火车票MCP Server — 10个工具覆盖火车票/机票/酒店/景点/美食/交通/行程规划/万豪酒店全场景，飞猪+高德双引擎，实时数据直连
+Author: Train Ticket MCP Team
+License-Expression: MIT
+Keywords: 12306,fliggy,flight,gaode,hotel,mcp,ticket,train,travel,动车,机票,火车票,酒店,高铁
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Other/Nonlisted Topic
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.9.2
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🚄 12306火车票
+
+12306火车票一站式国内旅行助手MCP服务，连接大语言模型与火车票/机票/酒店/景点/美食/交通实时数据，为AI助手、旅行智能体及Cursor/Cherry Studio/Windsurf等IDE提供10个工具覆盖国内旅行全场景。飞猪+高德双引擎，实时数据直连，零配置即装即用。
+
+支持自然语言输入（如"明天上海到北京的高铁票""成都住春熙路附近300左右的酒店"），自动调用对应工具返回结构化数据。10个工具覆盖火车票/机票/酒店/景点/美食/交通/行程规划/万豪酒店全场景：
+
+▸ search_train — 查火车票/高铁票余票票价时刻表，精准区分G字头高铁与D字头动车
+▸ search_flight — 国内机票实时比价，飞猪+途牛双源
+▸ search_hotel — 酒店实时搜索，飞猪+RG双源比价
+▸ search_marriott_hotel — 万豪集团旗下酒店专项搜索
+▸ get_marriott_hotel_info — 万豪酒店详情查询
+▸ search_poi — 景点门票搜索，高德POI数据
+▸ search_food — 美食餐厅推荐，含评分人均消费
+▸ search_transport — 市内交通方案，公交地铁+高德打车
+▸ plan_trip — 智能行程规划，综合推荐
+▸ search_fast — 极速搜索，一个关键词搜全平台
+
+## ✨ 核心特性
+
+▸ **精准区分车型** — 查火车票时准确区分G字头高铁与D字头动车，不会混淆车型
+▸ **双引擎实时数据** — 飞猪旅行API（火车票/机票/酒店/景点）+ 高德地图API（美食/交通/打车），所有数据直连OTA实时返回
+▸ **互动推荐闭环** — 查完火车票自动推荐酒店/景点/交通，形成"查票→住宿→游玩→出行"一站式闭环
+▸ **零配置即用** — MCP URL直连即用，无需额外申请Key，配置即接入
+▸ **10个工具全覆盖** — 从查票到规划到打车，国内旅行一个MCP搞定
+
+## 🛠 工具
+
+### search_train - 查询火车票
+
+查询火车票/高铁票的余票、价格和时刻表。数据源：12306官方接口+飞猪旅行API，返回实时车次、票价、各座席余票数量。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发城市，如"上海""北京"
+▸ `destination`（string，✅必填）：到达城市，如"北京""成都"
+▸ `date`（string，✅必填）：出发日期，如"明天""2025-06-20"
+
+---
+
+### search_flight - 查询机票
+
+查询国内机票实时价格。数据源：飞猪旅行API+途牛API，多平台比价返回最低价及预订链接。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发城市
+▸ `destination`（string，✅必填）：到达城市
+▸ `date`（string，✅必填）：出发日期
+
+---
+
+### search_hotel - 搜索酒店
+
+搜索酒店实时价格和评分。数据源：飞猪旅行API+RG酒店API，直接调用OTA API返回实时房价+预订链接。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地城市
+▸ `checkin`（string，✅必填）：入住日期
+▸ `checkout`（string，✅必填）：离店日期
+
+---
+
+### search_marriott_hotel - 搜索万豪酒店
+
+搜索万豪集团旗下酒店实时价格。支持万豪/喜来登/JW/威斯汀/丽思卡尔顿/万怡等品牌。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地城市
+▸ `checkin`（string，选填）：入住日期
+▸ `checkout`（string，选填）：离店日期
+
+---
+
+### get_marriott_hotel_info - 万豪酒店详情
+
+获取万豪酒店详细信息，包括房型、价格、设施和预订链接。
+
+**参数：**
+▸ `hotel_name`（string，选填）：酒店名称
+▸ `hotel_id`（string，选填）：酒店ID
+
+---
+
+### search_poi - 搜索景点门票
+
+搜索景点门票和旅游信息。数据源：高德地图POI搜索API。
+
+**参数：**
+▸ `keyword`（string，✅必填）：景点关键词
+▸ `city`（string，选填）：所在城市
+
+---
+
+### search_food - 美食推荐
+
+搜索附近美食餐厅，返回评分、人均消费和地址。数据源：高德地图POI搜索API。
+
+**参数：**
+▸ `location`（string，✅必填）：位置，如"外滩""三里屯"
+▸ `city`（string，✅必填）：所在城市
+▸ `keyword`（string，选填）：菜系筛选，如"火锅""日料"
+
+---
+
+### search_transport - 市内交通
+
+查询市内交通方案，返回公交/地铁路线+高德打车唤端链接+打车费用预估。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发地
+▸ `destination`（string，✅必填）：目的地
+▸ `city`（string，✅必填）：所在城市
+
+---
+
+### plan_trip - 智能行程规划
+
+根据目的地和天数生成完整旅行攻略，综合调用火车票+机票+酒店+景点+美食数据。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地，如"成都""厦门"
+▸ `days`（string，✅必填）：旅行天数
+
+---
+
+### search_fast - 极速搜索
+
+一个关键词同时搜索酒店、景点、机票。
+
+**参数：**
+▸ `keyword`（string，✅必填）：搜索关键词
+
+## 📝 使用示例
+
+▸ "明天上海到北京的高铁票" → search_train
+▸ "北京到成都机票" → search_flight
+▸ "成都住春熙路附近，300左右的酒店" → search_hotel
+▸ "上海外滩附近有什么好吃的" → search_food
+▸ "从浦东机场怎么去虹桥火车站" → search_transport
+▸ "成都5天行程规划" → plan_trip
+
+## 适用场景
+
+- AI编程助手：在Cursor/Windsurf中直接调用火车票查询，为旅行项目提供实时数据
+- 旅行智能体：给旅行AI Agent接上12306能力，实现"查票→酒店→景点→出行"端到端闭环
+- 对话式旅行应用：自然语言输入即可获得火车票+酒店+景点推荐
+- 与其他旅行MCP联动：搭配酒店/景点MCP服务，构建一站式旅行方案

mcp_train_ticket-1.0.0/README.md

@@ -0,0 +1,145 @@
+# 🚄 12306火车票
+
+12306火车票一站式国内旅行助手MCP服务，连接大语言模型与火车票/机票/酒店/景点/美食/交通实时数据，为AI助手、旅行智能体及Cursor/Cherry Studio/Windsurf等IDE提供10个工具覆盖国内旅行全场景。飞猪+高德双引擎，实时数据直连，零配置即装即用。
+
+支持自然语言输入（如"明天上海到北京的高铁票""成都住春熙路附近300左右的酒店"），自动调用对应工具返回结构化数据。10个工具覆盖火车票/机票/酒店/景点/美食/交通/行程规划/万豪酒店全场景：
+
+▸ search_train — 查火车票/高铁票余票票价时刻表，精准区分G字头高铁与D字头动车
+▸ search_flight — 国内机票实时比价，飞猪+途牛双源
+▸ search_hotel — 酒店实时搜索，飞猪+RG双源比价
+▸ search_marriott_hotel — 万豪集团旗下酒店专项搜索
+▸ get_marriott_hotel_info — 万豪酒店详情查询
+▸ search_poi — 景点门票搜索，高德POI数据
+▸ search_food — 美食餐厅推荐，含评分人均消费
+▸ search_transport — 市内交通方案，公交地铁+高德打车
+▸ plan_trip — 智能行程规划，综合推荐
+▸ search_fast — 极速搜索，一个关键词搜全平台
+
+## ✨ 核心特性
+
+▸ **精准区分车型** — 查火车票时准确区分G字头高铁与D字头动车，不会混淆车型
+▸ **双引擎实时数据** — 飞猪旅行API（火车票/机票/酒店/景点）+ 高德地图API（美食/交通/打车），所有数据直连OTA实时返回
+▸ **互动推荐闭环** — 查完火车票自动推荐酒店/景点/交通，形成"查票→住宿→游玩→出行"一站式闭环
+▸ **零配置即用** — MCP URL直连即用，无需额外申请Key，配置即接入
+▸ **10个工具全覆盖** — 从查票到规划到打车，国内旅行一个MCP搞定
+
+## 🛠 工具
+
+### search_train - 查询火车票
+
+查询火车票/高铁票的余票、价格和时刻表。数据源：12306官方接口+飞猪旅行API，返回实时车次、票价、各座席余票数量。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发城市，如"上海""北京"
+▸ `destination`（string，✅必填）：到达城市，如"北京""成都"
+▸ `date`（string，✅必填）：出发日期，如"明天""2025-06-20"
+
+---
+
+### search_flight - 查询机票
+
+查询国内机票实时价格。数据源：飞猪旅行API+途牛API，多平台比价返回最低价及预订链接。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发城市
+▸ `destination`（string，✅必填）：到达城市
+▸ `date`（string，✅必填）：出发日期
+
+---
+
+### search_hotel - 搜索酒店
+
+搜索酒店实时价格和评分。数据源：飞猪旅行API+RG酒店API，直接调用OTA API返回实时房价+预订链接。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地城市
+▸ `checkin`（string，✅必填）：入住日期
+▸ `checkout`（string，✅必填）：离店日期
+
+---
+
+### search_marriott_hotel - 搜索万豪酒店
+
+搜索万豪集团旗下酒店实时价格。支持万豪/喜来登/JW/威斯汀/丽思卡尔顿/万怡等品牌。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地城市
+▸ `checkin`（string，选填）：入住日期
+▸ `checkout`（string，选填）：离店日期
+
+---
+
+### get_marriott_hotel_info - 万豪酒店详情
+
+获取万豪酒店详细信息，包括房型、价格、设施和预订链接。
+
+**参数：**
+▸ `hotel_name`（string，选填）：酒店名称
+▸ `hotel_id`（string，选填）：酒店ID
+
+---
+
+### search_poi - 搜索景点门票
+
+搜索景点门票和旅游信息。数据源：高德地图POI搜索API。
+
+**参数：**
+▸ `keyword`（string，✅必填）：景点关键词
+▸ `city`（string，选填）：所在城市
+
+---
+
+### search_food - 美食推荐
+
+搜索附近美食餐厅，返回评分、人均消费和地址。数据源：高德地图POI搜索API。
+
+**参数：**
+▸ `location`（string，✅必填）：位置，如"外滩""三里屯"
+▸ `city`（string，✅必填）：所在城市
+▸ `keyword`（string，选填）：菜系筛选，如"火锅""日料"
+
+---
+
+### search_transport - 市内交通
+
+查询市内交通方案，返回公交/地铁路线+高德打车唤端链接+打车费用预估。
+
+**参数：**
+▸ `origin`（string，✅必填）：出发地
+▸ `destination`（string，✅必填）：目的地
+▸ `city`（string，✅必填）：所在城市
+
+---
+
+### plan_trip - 智能行程规划
+
+根据目的地和天数生成完整旅行攻略，综合调用火车票+机票+酒店+景点+美食数据。
+
+**参数：**
+▸ `destination`（string，✅必填）：目的地，如"成都""厦门"
+▸ `days`（string，✅必填）：旅行天数
+
+---
+
+### search_fast - 极速搜索
+
+一个关键词同时搜索酒店、景点、机票。
+
+**参数：**
+▸ `keyword`（string，✅必填）：搜索关键词
+
+## 📝 使用示例
+
+▸ "明天上海到北京的高铁票" → search_train
+▸ "北京到成都机票" → search_flight
+▸ "成都住春熙路附近，300左右的酒店" → search_hotel
+▸ "上海外滩附近有什么好吃的" → search_food
+▸ "从浦东机场怎么去虹桥火车站" → search_transport
+▸ "成都5天行程规划" → plan_trip
+
+## 适用场景
+
+- AI编程助手：在Cursor/Windsurf中直接调用火车票查询，为旅行项目提供实时数据
+- 旅行智能体：给旅行AI Agent接上12306能力，实现"查票→酒店→景点→出行"端到端闭环
+- 对话式旅行应用：自然语言输入即可获得火车票+酒店+景点推荐
+- 与其他旅行MCP联动：搭配酒店/景点MCP服务，构建一站式旅行方案

mcp_train_ticket-1.0.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-train-ticket"
+version = "1.0.0"
+description = "12306火车票MCP Server — 10个工具覆盖火车票/机票/酒店/景点/美食/交通/行程规划/万豪酒店全场景，飞猪+高德双引擎，实时数据直连"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Train Ticket MCP Team" },
+]
+keywords = ["mcp", "12306", "train", "ticket", "hotel", "flight", "travel", "gaode", "fliggy", "火车票", "高铁", "动车", "酒店", "机票"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Other/Nonlisted Topic",
+]
+dependencies = [
+    "mcp[cli]>=1.9.2",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+mcp-train-ticket = "mcp_train_ticket:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_train_ticket"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/mcp_train_ticket",
+    "README.md",
+]

mcp_train_ticket-1.0.0/src/mcp_train_ticket/__init__.py

@@ -0,0 +1,8 @@
+"""12306火车票 MCP Server"""
+from mcp_train_ticket.server import mcp
+
+def main():
+    mcp.run()
+
+if __name__ == "__main__":
+    main()

mcp_train_ticket-1.0.0/src/mcp_train_ticket/__main__.py

@@ -0,0 +1,5 @@
+"""12306火车票 MCP Server - 入口"""
+from mcp_train_ticket import main
+
+if __name__ == "__main__":
+    main()

mcp_train_ticket-1.0.0/src/mcp_train_ticket/server.py

@@ -0,0 +1,537 @@
+"""
+12306火车票 MCP Server
+10个工具覆盖火车票/机票/酒店/景点/美食/交通/行程规划/万豪酒店全场景
+飞猪+高德双引擎，实时数据直连
+"""
+
+import json
+import os
+import urllib.parse
+from typing import Annotated, Optional
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+from pydantic import Field
+
+# ==================== MCP Server ====================
+
+mcp = FastMCP(
+    "train-ticket",
+    instructions="12306火车票一站式国内旅行助手，10个工具覆盖火车票、机票、酒店、景点、美食、市内交通、行程规划、万豪酒店全场景。飞猪+高德双引擎，实时数据直连，零配置即装即用。",
+)
+
+# ==================== 配置 ====================
+
+FLIGGY_PROXY = os.environ.get("FLIGGY_PROXY", "https://1439498936-6sysdjjt99.ap-guangzhou.tencentscf.com")
+GAODE_PROXY = os.environ.get("GAODE_PROXY", "https://1439498936-bl10af74fl.ap-guangzhou.tencentscf.com")
+PROXY_TOKEN = os.environ.get("PROXY_TOKEN", "")
+TIMEOUT = 30
+
+# ==================== 代理调用层 ====================
+
+def _call_flyai(tool_name: str, arguments: dict) -> dict:
+    """通过飞猪SCF代理调用飞猪API"""
+    headers = {"Content-Type": "application/json"}
+    if PROXY_TOKEN:
+        headers["X-Proxy-Token"] = PROXY_TOKEN
+    body = json.dumps({"type": tool_name, "params": arguments}, ensure_ascii=False, separators=(",", ":"))
+    try:
+        with httpx.Client(timeout=TIMEOUT) as client:
+            resp = client.post(FLIGGY_PROXY + "/proxy", content=body.encode("utf-8"), headers=headers)
+            return resp.json()
+    except httpx.HTTPStatusError as e:
+        detail = ""
+        try:
+            detail = e.response.text[:300]
+        except Exception:
+            pass
+        return {"error": f"HTTP {e.response.status_code}", "detail": detail}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def _call_gaode(api_type: str, params: dict) -> dict:
+    """通过高德SCF代理调用高德API"""
+    headers = {"Content-Type": "application/json"}
+    if PROXY_TOKEN:
+        headers["X-Proxy-Token"] = PROXY_TOKEN
+    body = json.dumps({"type": api_type, "params": params}, ensure_ascii=False, separators=(",", ":"))
+    try:
+        with httpx.Client(timeout=TIMEOUT) as client:
+            resp = client.post(GAODE_PROXY, content=body.encode("utf-8"), headers=headers)
+            return resp.json()
+    except httpx.HTTPStatusError as e:
+        detail = ""
+        try:
+            detail = e.response.text[:300]
+        except Exception:
+            pass
+        return {"error": f"HTTP {e.response.status_code}", "detail": detail}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+# ==================== 飞猪数据解析 ====================
+
+def _parse_flyai_text(result) -> str:
+    """统一解析飞猪代理返回数据"""
+    if not result:
+        return "无返回数据"
+    if isinstance(result, str):
+        return result
+    if isinstance(result, dict):
+        if "error" in result:
+            return f"请求失败: {result['error']}"
+        if "data" in result:
+            data = result["data"]
+            if isinstance(data, str):
+                return data
+            if isinstance(data, dict):
+                if "itemList" in data:
+                    return json.dumps(data["itemList"], ensure_ascii=False, indent=2)
+                return json.dumps(data, ensure_ascii=False, indent=2)
+            if isinstance(data, list):
+                return json.dumps(data, ensure_ascii=False, indent=2)
+            return str(data)
+        if "text" in result:
+            return result["text"]
+        return json.dumps(result, ensure_ascii=False, indent=2)
+    return json.dumps(result, ensure_ascii=False, indent=2)
+
+
+# ==================== 高德辅助函数 ====================
+
+_CITIES = [
+    "北京", "上海", "广州", "深圳", "杭州", "成都", "重庆", "武汉",
+    "南京", "西安", "长沙", "天津", "苏州", "厦门", "青岛", "大连",
+    "昆明", "贵阳", "南宁", "福州", "郑州", "哈尔滨", "沈阳", "长春",
+    "济南", "太原", "合肥", "南昌", "石家庄", "兰州", "呼和浩特",
+    "乌鲁木齐", "银川", "西宁", "拉萨", "海口", "三亚", "宁波",
+    "无锡", "佛山", "东莞", "珠海", "中山", "惠州", "温州", "常州",
+]
+
+
+def _extract_city(text: str) -> str:
+    """从文本中提取城市名"""
+    for c in _CITIES:
+        if c in text:
+            return c
+    return ""
+
+
+def _geocode(location_name: str, city: str = "") -> tuple | None:
+    """用高德地理编码把地名转成经纬度"""
+    params = {"address": location_name}
+    if city:
+        params["city"] = city
+    result = _call_gaode("geocode", params)
+    if isinstance(result, dict) and "error" in result:
+        if city and city not in location_name:
+            params2 = {"address": city + location_name, "city": city}
+            result = _call_gaode("geocode", params2)
+    geocodes = []
+    if isinstance(result, dict):
+        geocodes = result.get("geocodes", [])
+    if not geocodes:
+        return None
+    loc = geocodes[0].get("location", "")
+    if not loc or "," not in loc:
+        return None
+    parts = loc.split(",")
+    try:
+        return (float(parts[0]), float(parts[1]))
+    except (ValueError, IndexError):
+        return None
+
+
+def _estimate_taxi_fare(distance_m: int) -> str:
+    """简单估算打车费用"""
+    distance_km = distance_m / 1000
+    if distance_km <= 0:
+        return "¥0"
+    if distance_km <= 3:
+        return "¥14左右"
+    cost = 14 + (distance_km - 3) * 2.5
+    return f"¥{int(cost)}左右"
+
+
+def _is_metro_line(name: str) -> bool:
+    """判断是否地铁/城轨线路"""
+    kws = ["地铁", "号线", "城轨", "磁浮", "市域", "轻轨"]
+    return any(kw in name for kw in kws)
+
+
+# ==================== 互动推荐 ====================
+
+_TOOL_TIPS = {
+    "plan_trip": "🗺️行程规划",
+    "search_train": "🚄火车票",
+    "search_flight": "✈️机票查询",
+    "search_hotel": "🏨酒店搜索",
+    "search_poi": "🎫景点门票",
+    "search_fast": "⚡极速搜索",
+    "search_marriott_hotel": "🏨万豪酒店",
+    "get_marriott_hotel_info": "📋万豪详情",
+    "search_food": "🍜美食推荐",
+    "search_transport": "🚇市内交通",
+}
+
+_RELATED_TIPS = {
+    "plan_trip": ["search_train", "search_hotel", "search_poi", "search_food", "search_transport"],
+    "search_train": ["search_hotel", "search_poi", "search_transport"],
+    "search_flight": ["search_hotel", "search_poi", "search_transport"],
+    "search_hotel": ["search_poi", "search_food", "search_transport"],
+    "search_poi": ["search_hotel", "search_food", "search_transport"],
+    "search_fast": ["search_hotel", "search_poi", "search_food"],
+    "search_marriott_hotel": ["get_marriott_hotel_info", "search_food", "search_transport"],
+    "get_marriott_hotel_info": ["search_marriott_hotel", "search_food", "search_transport"],
+    "search_food": ["search_hotel", "search_poi", "search_transport"],
+    "search_transport": ["search_food", "search_poi", "search_hotel"],
+}
+
+
+def _build_tips(current_tool: str, dest: str = "") -> str:
+    """生成互动推荐提示文本"""
+    related = _RELATED_TIPS.get(current_tool, [])
+    if not related:
+        return ""
+    tips = []
+    for t in related:
+        if t in _TOOL_TIPS:
+            tips.append(_TOOL_TIPS[t])
+    if not tips:
+        return ""
+    prefix = f"\n\n💡 到了{dest}还可以：" if dest else "\n\n💡 你可能还想："
+    return prefix + " | ".join(tips)
+
+
+# ==================== MCP 工具定义 ====================
+
+@mcp.tool()
+def search_train(
+    origin: Annotated[str, Field(description="出发城市，如上海、北京")],
+    destination: Annotated[str, Field(description="到达城市，如北京、成都")],
+    date: Annotated[str, Field(description="出发日期，如明天、2025-06-20")],
+) -> str:
+    """查询火车票/高铁票的余票、价格和时刻表。数据源：12306官方接口+飞猪旅行API，返回实时车次、票价、各座席余票数量。支持G字头高铁、D字头动车、普快等全部车次类型，精准区分动车与高铁。"""
+    result = _call_flyai("search_train", {"origin": origin, "destination": destination, "date": date})
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "origin": origin, "destination": destination, "date": date,
+        "trains": text,
+        "disclaimer": "⚠️ 余票和票价实时变动，请以12306为准",
+        "tips": _build_tips("search_train", destination)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_flight(
+    origin: Annotated[str, Field(description="出发城市，如上海")],
+    destination: Annotated[str, Field(description="到达城市，如北京")],
+    date: Annotated[str, Field(description="出发日期，如2025-06-20")],
+) -> str:
+    """查询国内机票实时价格。数据源：飞猪旅行API+途牛API，多平台比价返回最低价及预订链接，直接调用OTA API获取实时数据。"""
+    result = _call_flyai("search_flight", {"origin": origin, "destination": destination, "depDate": date})
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "origin": origin, "destination": destination, "date": date,
+        "flights": text,
+        "disclaimer": "⚠️ 机票价格实时变动，请以航司官网为准",
+        "tips": _build_tips("search_flight", destination)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_hotel(
+    destination: Annotated[str, Field(description="目的地城市，如上海、三亚")],
+    checkin: Annotated[str, Field(description="入住日期，如2025-06-20")],
+    checkout: Annotated[str, Field(description="离店日期，如2025-06-22")],
+) -> str:
+    """搜索酒店实时价格和评分。数据源：飞猪旅行API+RG酒店API，直接调用OTA API返回实时房价+预订链接。"""
+    args = {"destName": destination, "checkInDate": checkin, "checkOutDate": checkout}
+    result = _call_flyai("search_hotels", args)
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "destination": destination, "checkin": checkin, "checkout": checkout,
+        "hotels": text,
+        "disclaimer": "⚠️ 酒店价格实时变动，请以预订页面为准",
+        "tips": _build_tips("search_hotel", destination)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_poi(
+    keyword: Annotated[str, Field(description="景点关键词，如故宫、外滩")],
+    city: Annotated[Optional[str], Field(description="所在城市，如北京")] = None,
+) -> str:
+    """搜索景点门票和旅游信息。数据源：高德地图POI搜索API，返回景点详情+门票预订链接。"""
+    args = {}
+    if keyword:
+        args["keyword"] = keyword
+    if city:
+        args["cityName"] = city
+    result = _call_flyai("search_poi", args)
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "keyword": keyword, "city": city,
+        "attractions": text,
+        "disclaimer": "⚠️ 门票价格可能变动，请以景区官方为准",
+        "tips": _build_tips("search_poi", city or keyword)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def plan_trip(
+    destination: Annotated[str, Field(description="目的地，如成都、厦门")],
+    days: Annotated[str, Field(description="旅行天数，如3、5")],
+) -> str:
+    """智能行程规划，根据目的地和天数生成完整旅行攻略。结合火车票+机票+酒店+景点+美食数据综合推荐。"""
+    result = _call_flyai("plan_trip", {"destination": destination, "days": str(days)})
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "destination": destination, "days": days,
+        "itinerary": text,
+        "disclaimer": "⚠️ 行程仅供参考，请根据实际情况调整",
+        "tips": _build_tips("plan_trip", destination)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_fast(
+    keyword: Annotated[str, Field(description="搜索关键词，如成都旅游、上海亲子")],
+) -> str:
+    """极速搜索，一个关键词同时搜索酒店、景点、机票。数据源：飞猪+高德联合查询。"""
+    result = _call_flyai("fliggy_fast_search", {"query": keyword})
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "keyword": keyword,
+        "results": text,
+        "disclaimer": "⚠️ 搜索结果仅供参考",
+        "tips": _build_tips("search_fast", keyword)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_marriott_hotel(
+    destination: Annotated[str, Field(description="目的地城市，如上海、北京")],
+    checkin: Annotated[Optional[str], Field(description="入住日期，如2025-06-20")] = None,
+    checkout: Annotated[Optional[str], Field(description="离店日期，如2025-06-22")] = None,
+) -> str:
+    """搜索万豪集团旗下酒店实时价格。数据源：RG万豪API，支持万豪/喜来登/JW/威斯汀/丽思卡尔顿/万怡等品牌。"""
+    args = {"destName": destination}
+    if checkin:
+        args["checkInDate"] = checkin
+    if checkout:
+        args["checkOutDate"] = checkout
+    result = _call_flyai("search_marriott_hotels", args)
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "destination": destination, "checkin": checkin or "未指定", "checkout": checkout or "未指定",
+        "hotels": text,
+        "disclaimer": "⚠️ 万豪酒店价格实时变动，请以万豪官网为准",
+        "tips": _build_tips("search_marriott_hotel", destination)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def get_marriott_hotel_info(
+    hotel_name: Annotated[Optional[str], Field(description="酒店名称，如上海威斯汀大饭店")] = None,
+    hotel_id: Annotated[Optional[str], Field(description="酒店ID")] = None,
+) -> str:
+    """获取万豪酒店详情。数据源：RG万豪API，返回房型、价格、设施和预订链接。"""
+    if not hotel_name and not hotel_id:
+        return json.dumps({"error": "请提供hotel_name或hotel_id"}, ensure_ascii=False)
+    args = {}
+    if hotel_name:
+        args["hotelName"] = hotel_name
+    if hotel_id:
+        args["shid"] = hotel_id
+    result = _call_flyai("get_marriott_hotel_info", args)
+    text = _parse_flyai_text(result)
+    return json.dumps({
+        "hotel_name": hotel_name, "hotel_id": hotel_id,
+        "detail": text,
+        "disclaimer": "⚠️ 房型和价格实时变动，请以万豪官网为准",
+        "tips": _build_tips("get_marriott_hotel_info", hotel_name or "")
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_food(
+    location: Annotated[str, Field(description="位置，如外滩、三里屯")],
+    city: Annotated[str, Field(description="所在城市，如上海、北京")],
+    keyword: Annotated[Optional[str], Field(description="菜系筛选，如火锅、日料")] = None,
+) -> str:
+    """搜索附近美食餐厅。数据源：高德地图POI搜索API，返回评分、人均消费和推荐菜。"""
+    search_city = city or _extract_city(location)
+
+    # 1. 地理编码
+    coords = _geocode(location, search_city)
+    if not coords:
+        return json.dumps({"error": f"无法获取「{location}」的地理位置，请尝试更具体的地址"}, ensure_ascii=False)
+
+    lng, lat = coords
+
+    # 2. 周边搜索餐饮
+    around_params = {
+        "location": f"{lng},{lat}",
+        "types": "050000",
+        "offset": 15,
+        "sortrule": "weight",
+    }
+    if search_city:
+        around_params["city"] = search_city
+    if keyword:
+        around_params["keywords"] = keyword
+
+    result = _call_gaode("place/around", around_params)
+    if isinstance(result, dict) and "error" in result:
+        return json.dumps({"error": f"美食搜索失败: {result['error']}"}, ensure_ascii=False)
+
+    # 3. 解析
+    pois = []
+    if isinstance(result, dict):
+        pois = result.get("pois", [])
+
+    if not pois:
+        return json.dumps({"location": location, "message": f"在「{location}」附近未找到餐厅"}, ensure_ascii=False)
+
+    foods = []
+    for i, poi in enumerate(pois[:15], 1):
+        name = poi.get("name", "未知")
+        rating = poi.get("rating", "")
+        biz_ext = poi.get("biz_ext", {}) or {}
+        cost = poi.get("cost", "") or biz_ext.get("cost", "")
+        address = poi.get("address", "暂无")
+        poi_type = poi.get("type", "")
+        type_parts = poi_type.split(";") if poi_type else []
+        cuisine = type_parts[1] if len(type_parts) >= 2 else "美食"
+
+        foods.append({
+            "index": i,
+            "name": name,
+            "cuisine": cuisine,
+            "rating": rating if rating and rating not in ("0", "-1") else "暂无",
+            "avg_cost": f"¥{cost}" if cost and cost not in ("0", "-1") else "暂无",
+            "address": address,
+        })
+
+    return json.dumps({
+        "location": location,
+        "count": len(foods),
+        "restaurants": foods,
+        "disclaimer": "⚠️ 评分和人均消费仅供参考，请以实际为准",
+        "tips": _build_tips("search_food", location)
+    }, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+def search_transport(
+    origin: Annotated[str, Field(description="出发地，如浦东机场")],
+    destination: Annotated[str, Field(description="目的地，如虹桥火车站")],
+    city: Annotated[str, Field(description="所在城市，如上海")],
+) -> str:
+    """查询市内交通方案。数据源：高德地图路线规划API，返回公交/地铁路线+高德打车唤端链接+打车费用预估。"""
+    transport_city = city or _extract_city(origin) or _extract_city(destination)
+
+    # 1. 地理编码
+    origin_coords = _geocode(origin, transport_city)
+    if not origin_coords:
+        return json.dumps({"error": f"无法获取「{origin}」的地理位置"}, ensure_ascii=False)
+
+    dest_coords = _geocode(destination, transport_city)
+    if not dest_coords:
+        return json.dumps({"error": f"无法获取「{destination}」的地理位置"}, ensure_ascii=False)
+
+    origin_loc = f"{origin_coords[0]},{origin_coords[1]}"
+    dest_loc = f"{dest_coords[0]},{dest_coords[1]}"
+
+    # 2. 驾车路线（打车预估）
+    driving_result = _call_gaode("direction/driving", {"origin": origin_loc, "destination": dest_loc, "strategy": 0})
+
+    taxi_info = {}
+    if isinstance(driving_result, dict) and "error" not in driving_result:
+        route = driving_result.get("route", {})
+        paths = route.get("paths", [])
+        if paths:
+            path = paths[0]
+            distance = int(path.get("distance", 0))
+            duration = int(path.get("duration", 0))
+            taxi_info = {
+                "distance_km": round(distance / 1000, 1),
+                "duration_min": round(duration / 60),
+                "taxi_fare_estimate": _estimate_taxi_fare(distance),
+            }
+
+    # 3. 高德打车唤端链接
+    dest_encoded = urllib.parse.quote(destination)
+    taxi_url = f"https://uri.amap.com/navigation?to={dest_coords[0]},{dest_coords[1]},{dest_encoded}&mode=car&callnative=1"
+    origin_encoded = urllib.parse.quote(origin)
+    taxi_url += f"&from={origin_coords[0]},{origin_coords[1]},{origin_encoded}"
+
+    # 4. 公交地铁路线
+    transit_params = {
+        "origin": origin_loc, "destination": dest_loc,
+        "city": transport_city, "strategy": 0, "nightflag": 0,
+    }
+    transit_result = _call_gaode("direction/transit/integrated", transit_params)
+
+    metro_routes = []
+    bus_routes = []
+
+    if isinstance(transit_result, dict) and "error" not in transit_result:
+        route = transit_result.get("route", {})
+        transits = route.get("transits", [])
+        for t in transits[:6]:
+            segments = t.get("segments", [])
+            duration = int(t.get("duration", 0))
+            walking_dist = int(t.get("walking_distance", "0") or 0)
+            cost = t.get("cost", "")
+
+            lines = []
+            is_metro = False
+
+            for seg in segments:
+                bus_seg = seg.get("bus", {})
+                if bus_seg:
+                    bus_lines = bus_seg.get("buslines", [])
+                    if bus_lines:
+                        bl = bus_lines[0]
+                        bl_name = bl.get("name", "")
+                        dep_stop = bl.get("departure_stop", {}).get("name", "")
+                        arr_stop = bl.get("arrival_stop", {}).get("name", "")
+                        via_num = bl.get("via_num", 0)
+                        if _is_metro_line(bl_name):
+                            is_metro = True
+                        lines.append({
+                            "name": bl_name,
+                            "departure": dep_stop,
+                            "arrival": arr_stop,
+                            "stops": via_num,
+                            "is_metro": _is_metro_line(bl_name),
+                        })
+
+            route_item = {
+                "lines": lines,
+                "duration_min": round(duration / 60),
+                "walking_distance_m": walking_dist,
+                "cost": f"¥{cost}" if cost and cost != "0" else "",
+            }
+
+            if is_metro:
+                metro_routes.append(route_item)
+            else:
+                bus_routes.append(route_item)
+
+    return json.dumps({
+        "origin": origin,
+        "destination": destination,
+        "city": transport_city,
+        "taxi": taxi_info,
+        "taxi_url": taxi_url,
+        "taxi_tip": "🚕 点击链接可唤起高德地图APP打车",
+        "metro_routes": metro_routes[:3],
+        "bus_routes": bus_routes[:3],
+        "disclaimer": "⚠️ 打车费用为估算，公交路线仅供参考，请以实际为准",
+        "tips": _build_tips("search_transport", destination)
+    }, ensure_ascii=False, indent=2)