Metadata-Version: 2.4
Name: mcp-global-travel
Version: 0.3.0
Summary: 出境游旅行助手MCP Server — 11个工具覆盖签证/机票/酒店/安全/插头/退税/汇率/紧急求助全场景，RG云端代理+本地知识数据库+免费汇率API
Author: Global Travel MCP Team
License-Expression: MIT
Keywords: exchange-rate,flight,hotel,mcp,outbound,safety,tax-refund,travel,visa,出境游,汇率,签证,航班,退税,酒店
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

# 🌏 出境游旅行助手

出境游一站式全链路MCP服务，11个工具覆盖从签证到退税的完整出境需求。

## ✨ 核心特性

▸ 5大实时数据工具 — 机票搜索、酒店搜索、航班座位、航班行李、酒店房型，通过RG云端代理获取全球实时数据
▸ 4大本地知识库 — 签证查询（30+国家）、安全评级（30+国家）、插头电压（30+国家）、紧急求助（30+国家使领馆+7类应急指南）
▸ 退税计算器 — 15个国家退税政策，自动计算到手金额、手续费和起退差额
▸ 实时汇率换算 — 支持150+货币，免费API零配置
▸ 全链路闭环 — 签证→机票→酒店→安全→插头→退税→汇率→紧急，一站式覆盖

## 🛠 工具

### search_flights
搜索国际机票，输入出发城市、到达城市和日期，返回航班信息和预订链接
▸ `origin`（str，✅必填）：出发城市，如'北京''PEK'
▸ `destination`（str，✅必填）：目的城市，如'东京''NRT'
▸ `date`（str，✅必填）：出发日期，格式YYYY-MM-DD

### search_hotels
搜索国际酒店，输入城市、入住日期和离店日期，返回酒店列表和预订链接
▸ `city`（str，✅必填）：城市名称，如'东京''巴黎''曼谷'
▸ `checkin`（str，✅必填）：入住日期，格式YYYY-MM-DD
▸ `checkout`（str，✅必填）：离店日期，格式YYYY-MM-DD

### flight_seats
查询航班座位布局和选座价格，输入航班号和日期
▸ `flight_number`（str，✅必填）：航班号，如'CA929''JL861'
▸ `date`（str，选填）：航班日期，格式YYYY-MM-DD

### flight_baggage
查询航班行李额度和额外费用，输入航班号和日期
▸ `flight_number`（str，✅必填）：航班号，如'CA929''JL861'
▸ `date`（str，选填）：航班日期，格式YYYY-MM-DD

### hotel_detail
查看酒店房型价格和退改政策，输入酒店ID和入住离店日期
▸ `hotel_id`（str，✅必填）：酒店ID，从search_hotels结果中获取
▸ `checkin`（str，选填）：入住日期，格式YYYY-MM-DD
▸ `checkout`（str，选填）：离店日期，格式YYYY-MM-DD

### check_visa
查询目的地签证要求，包括签证类型、费用、停留天数、办理时间和材料清单
▸ `destination`（str，✅必填）：目的地，如'日本''巴黎''USA'
▸ `purpose`（str，选填）：出行目的：tourism=旅游(默认)/business=商务/transit=过境

### check_safety
查询目的地安全评级，包括犯罪、恐怖袭击、自然灾害、健康、交通五维评分和风险提示
▸ `destination`（str，✅必填）：目的地，如'泰国''巴黎''巴西'

### check_plug
查询目的地插头类型、电压、频率和是否需要转换器
▸ `destination`（str，✅必填）：目的地，如'日本''英国''澳洲'

### emergency_help
出境紧急求助，提供当地报警/急救电话、中国使领馆联系方式和应急场景处理指南
▸ `destination`（str，选填）：目的地，如'泰国''巴黎'，用于获取当地紧急电话和使领馆信息
▸ `emergency_type`（str，选填）：紧急类型，如'护照丢失''航班取消''生病''被盗''地震''车祸''被捕'

### calc_tax_refund
计算出境购物退税金额，包括退税率、手续费、实际到手金额和退税流程
▸ `destination`（str，✅必填）：目的地，如'日本''法国''澳大利亚'
▸ `amount`（str，✅必填）：购物金额，数字
▸ `currency`（str，选填）：货币代码，如'JPY''EUR'

### exchange_rate
实时汇率换算，支持150+主流货币
▸ `from_currency`（str，✅必填）：源币种代码，如'USD''CNY''JPY'
▸ `to_currency`（str，✅必填）：目标币种代码，如'CNY''JPY''EUR'
▸ `amount`（str，选填）：换算金额，默认1

## 📝 使用示例

▸ "去日本要办签证吗" → check_visa(destination="日本")
▸ "查一下明天北京飞东京的航班" → search_flights(origin="北京", destination="东京", date="2026-06-15")
▸ "东京新宿有什么酒店推荐" → search_hotels(city="东京", checkin="2026-06-15", checkout="2026-06-18")
▸ "CA929这个航班座位怎么样" → flight_seats(flight_number="CA929")
▸ "飞日本能带多少行李" → flight_baggage(flight_number="CA929")
▸ "这个酒店有什么房型" → hotel_detail(hotel_id="xxx", checkin="2026-06-15", checkout="2026-06-18")
▸ "泰国安全吗" → check_safety(destination="泰国")
▸ "去英国需要带转换插头吗" → check_plug(destination="英国")
▸ "在日本买了5万日元的东西能退多少税" → calc_tax_refund(destination="日本", amount="50000")
▸ "1000人民币能换多少日元" → exchange_rate(from_currency="CNY", to_currency="JPY", amount="1000")

## 适用场景

▸ 出境游行前准备 — 查签证、查安全、查插头、规划机票酒店
▸ 出境游途中应急 — 护照丢失、航班取消、突发疾病，一键获取使领馆电话和应急指南
▸ 出境购物退税 — 计算到手金额、了解退税流程、查看起退门槛
▸ 出境花费预算 — 实时汇率换算，多币种费用估算
