Metadata-Version: 2.4
Name: travel-agent-tools
Version: 1.0.0
Summary: 旅行特工队 - 工具层：面向智能旅行规划的 MCP 工具集（华为ICT创新赛）
Author: Travel Agent Team
License: MIT
Keywords: mcp,travel,agent,huawei,agentarts
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 :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: Jinja2>=3.1.2
Requires-Dist: reportlab>=4.0.4
Requires-Dist: beautifulsoup4>=4.12.3
Requires-Dist: loguru>=0.7.2
Requires-Dist: python-dotenv>=1.0.1

# 旅行特工队 - 工具层（travel-agent-tools）

> 华为 ICT 创新赛参赛作品 · 智果(AgentArts)平台 MCP 工具集

面向年轻群体的智能旅行规划系统 **工具层**，通过 MCP（Model Context Protocol）协议对外提供
7 大类共 **30 个工具**，可直接接入智果(AgentArts)智能体平台。

## 工具清单

| 模块 | 工具 |
|---|---|
| 地图 MCP | `search_poi` `planning_route` `geocode_address` `reverse_geocode` `search_around` |
| 空间计算 MCP | `calculate_distance` `estimate_commute_time` `optimize_route_order` `find_enroute_attractions` `get_pois_center` `split_pois_by_day` |
| 数据采集 | `fetch_reviews` `clean_reviews` `analyze_rating` `prioritize_pois` `summarize_reviews` |
| HTML 生成 | `generate_travel_guide_html` `generate_checklist_html` `generate_photo_spots_html` `generate_share_card_html` |
| PDF 生成 | `generate_checklist_pdf` `generate_itinerary_pdf` `generate_photo_guide_pdf` |
| 接口跳转 | `generate_booking_links` `generate_countdown` `aggregate_booking_status` `generate_calendar_reminder` |
| 抢票步骤 | `generate_ticket_steps` `generate_recommended_platform` `generate_ticket_tips` |

> 未配置 `AMAP_API_KEY` 时，地图类工具自动降级为示例数据，服务仍可启动与联调。

## 本地部署

```bash
# 1. 安装依赖（Python 3.10+）
pip install -r requirements.txt

# 2. 配置环境变量
copy .env.example .env
# 编辑 .env，填入高德地图 API Key（https://lbs.amap.com/ 申请）

# 3. 验证
python server.py --list
python server.py --test "search_poi:keyword=故宫,city=北京"

# 4. 启动
python server.py --http --port 8000   # HTTP 模式（测试）
python server.py                      # stdio 模式（MCP 标准，智果平台用）
```

HTTP 模式端点：`GET /`（健康检查）、`GET /tools`（工具列表）、`POST /tools/call`（调用工具）。

## 智果(AgentArts)平台部署

1. 登录 https://www.huaweicloud.com/product/agentarts.html 智果平台控制台（需完成认证）
2. 「连接器管理」→「新建连接器」：类型 MCP Server，运行环境 Python 3.10+
3. 上传 `travel-agent-tools.zip` 代码包，启动命令：`python server.py`
4. 环境变量：`AMAP_API_KEY`（必填）、`MCP_SERVER_NAME=travel-agent-tools`、`LOG_LEVEL=INFO`
5. 资源规格：开发测试 0.5核1GB 即可（本项目为轻量 CPU 应用）
6. 部署 → 测试连接 → 在智能体中绑定连接器并勾选工具

## 扩展开发

1. 在 `tools/<模块>/` 实现新函数
2. 在 `tools/__init__.py` 的 `HANDLERS` 与 `TOOLS` 中注册
3. 重新打包部署到智果平台

## 技术栈

Python 3.10+ · MCP(JSON-RPC over stdio) · 高德地图 API · Jinja2 · ReportLab · BeautifulSoup4 · Haversine · Loguru

---
版本 v1.0.0 · 华为 ICT 创新赛 - 旅行特工队
