Metadata-Version: 2.4
Name: mcp-poi-smart-recommend
Version: 1.0.0
Summary: 国内景点智能推荐MCP Server - 景点搜索/门票价格/购票链接/5A景区筛选
Author: mako2026
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: cryptography>=42.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.9.2
Description-Content-Type: text/markdown

# 国内景点智能推荐 MCP Server

这是一个专注国内景点门票的智能推荐MCP服务，为AI助手、旅行智能体及Cursor/Cherry Studio/Windsurf等IDE提供覆盖全国范围的景点搜索、门票价格查询与购票链接生成能力，满足各类景点查询与出行规划需求。该服务支持通过城市名称、景点关键词等多种方式进行精准搜索，并提供灵活的景区等级筛选（5A/4A/3A）、景点类型分类等专业筛选功能。此外，服务返回景点介绍、评分、门票价格及可直接购票的官方链接等结构化数据，支持按关键词快速定位目标景点。整个服务通过标准MCP协议交互，智能完成从城市解析、景点筛选、门票查询到购票链接生成的完整服务流程，为旅行智能体搭建、AI编程助手集成及对话式旅行应用提供精准、高效的国内景点检索与购票解决方案。

## 工具列表

### search_poi - 景点门票搜索

搜索国内景点，返回门票价格和购票链接。支持按城市、关键词、景区等级筛选。

参数：
- `city`（必填）：城市，如"深圳""杭州""北京"
- `keyword`：景点关键词，如：西湖、长城、迪士尼
- `category`：景点类型
- `level`：景区等级 1-5（5=5A级景区）
- `limit`：返回数量，默认10

## 安装

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

或使用 uvx 直接运行：

```bash
uvx mcp-poi-smart-recommend
```

## 配置

需要设置以下环境变量：

| 变量名 | 说明 | 获取方式 |
|--------|------|---------|
| FLYAI_API_KEY | FlyAI API密钥 | https://flyai.open.fliggy.com 注册获取 |
| FLYAI_SIGN_SECRET | FlyAI签名密钥 | 同上 |

### 在 MCP 客户端中配置

```json
{
  "mcpServers": {
    "poi-smart-recommend": {
      "command": "uvx",
      "args": ["mcp-poi-smart-recommend"],
      "env": {
        "FLYAI_API_KEY": "你的API密钥",
        "FLYAI_SIGN_SECRET": "你的签名密钥"
      }
    }
  }
}
```

## 适用场景

- **AI编程助手**：在Cursor/Windsurf中直接调用景点搜索，为旅行规划项目提供数据
- **旅行智能体**：给旅行AI Agent接上景点能力，实现"推荐景点→查门票→给链接"闭环
- **对话式旅行应用**：低延迟响应，适配实时对话场景
- **与酒店服务联动**：搭配酒店MCP服务，构建"住+玩"一站式旅行方案

## 技术特性

- 基于MCP（Model Context Protocol）标准
- 支持景区等级筛选（5A/4A/3A）
- 返回结构化数据：景点介绍、评分、门票价格、购票链接
- SSE流式响应支持

## License

MIT
