旅行特工队 - 工具层(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时,地图类工具自动降级为示例数据,服务仍可启动与联调。
本地部署
# 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)平台部署
- 登录 https://www.huaweicloud.com/product/agentarts.html 智果平台控制台(需完成认证)
- 「连接器管理」→「新建连接器」:类型 MCP Server,运行环境 Python 3.10+
- 上传
travel-agent-tools.zip代码包,启动命令:python server.py - 环境变量:
AMAP_API_KEY(必填)、MCP_SERVER_NAME=travel-agent-tools、LOG_LEVEL=INFO - 资源规格:开发测试 0.5核1GB 即可(本项目为轻量 CPU 应用)
- 部署 → 测试连接 → 在智能体中绑定连接器并勾选工具
扩展开发
- 在
tools/<模块>/实现新函数 - 在
tools/__init__.py的HANDLERS与TOOLS中注册 - 重新打包部署到智果平台
技术栈
Python 3.10+ · MCP(JSON-RPC over stdio) · 高德地图 API · Jinja2 · ReportLab · BeautifulSoup4 · Haversine · Loguru
版本 v1.0.0 · 华为 ICT 创新赛 - 旅行特工队
Metadata
Release files for travel-agent-tools 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| travel_agent_tools-1.0.0.tar.gz | 29.9 kB | Without provenance | Details for travel_agent_tools-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| travel_agent_tools-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for travel_agent_tools-1.0.0-py3-none-any.whl |
Total release size: 65.0 kB
Release files / travel_agent_tools-1.0.0.tar.gz
| Download URL | travel_agent_tools-1.0.0.tar.gz |
|---|---|
| Size | 29.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
603ddc058c2d9ce508c947f3af765018943e7146f21b5aae78a0d26bbd1916e0
|
|
BLAKE2b-256 checksum How to use checksums |
99fc9d654f439efd5059ad7dc1d2239cefb06299249fc0e2dd6d5ec733dea6e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Release files / travel_agent_tools-1.0.0-py3-none-any.whl
| Download URL | travel_agent_tools-1.0.0-py3-none-any.whl |
|---|---|
| Size | 35.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc16c878ec0187ff4cb247f129e5178b3dfec5c807c799f2cccc36b377f6a700
|
|
BLAKE2b-256 checksum How to use checksums |
7328227d3797a2b5cd453afb29a55f5a2476edf1b6fae9a4a384996be16d1620
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Security for travel-agent-tools 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.