Metadata-Version: 2.4
Name: mcp-poi-smart-recommend
Version: 5.0.1
Summary: 国内景点智能推荐 MCP Server - 飞猪旅行+高德地图，6合1景点推荐服务
Author: mako2026
License: MIT
Keywords: mcp,poi,attraction,travel,fliggy,ticket
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0

# mcp-poi-smart-recommend

国内景点智能推荐 MCP Server - 飞猪旅行 + 高德地图，6 合 1 景点推荐服务。

## 功能特点

- 🎯 **AI 智能推荐**：自然语言描述，AI 推荐最合适的景点
- 🔍 **结构化搜索**：按关键词、城市、类型、等级筛选景点门票
- ⚡ **极速搜索**：快速查询景点、门票、线路等信息
- 📍 **周边发现**：基于位置搜索附近景点，返回距离、评分、地址
- 🌤️ **天气预报**：查询目的地天气，辅助出行决策
- 🚗 **交通规划**：含打车预估、地铁/公交换乘方案 + 一键打车链接

## 数据源

- **飞猪旅行**：景点门票价格、预订链接（3 个工具）
- **高德地图**：位置、周边、天气、交通服务（3 个工具）

## 安装

```bash
pip install mcp-poi-smart-recommend
```

## 工具列表

### 飞猪旅行（camelCase 参数，与官方 FlyAI Schema 100% 兼容）

| 工具名 | 说明 | 参数 |
|-------|-----|------|
| `recommend_poi` | AI 智能推荐景点 | `query`（必填） |
| `search_poi` | 结构化搜索景点门票 | `cityName`（必填）, `keyword`, `category`, `poiLevel` |
| `search_fast` | 极速搜索 | `query`（必填） |

### 高德地图

| 工具名 | 说明 | 参数 |
|-------|-----|------|
| `nearby_poi` | 周边景点发现 | `location`（必填）, `city`, `radius` |
| `search_weather` | 天气预报查询 | `query`（必填） |
| `search_transport` | 交通方案规划 | `query`（必填） |

## v5.0.0 更新

- 飞猪工具参数名全部改为 camelCase，与飞猪官方 FlyAI Skill schema 100% 兼容
- `search_poi` 参数调整：`city` → `cityName`、`poi_level` → `poiLevel`
- 移除多余参数 `showTicket`（飞猪官方 schema 无此参数）
- `cityName` 调整为必填，与官方 schema 必填性对齐
- 移除内部 snake_case → camelCase 映射层，参数直接透传
- 构建工具从 hatchling 切换为 setuptools

## License

MIT
