Metadata-Version: 2.4
Name: mcp-travel-smart-plan
Version: 1.0.0
Summary: 旅行智能规划MCP Server - 自然语言旅行方案/酒店景点推荐/行程安排
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提供基于自然语言的多日行程智能规划能力，满足各类旅行安排与目的地选择需求。该服务支持自然语言描述需求（如"三亚蜜月预算1万""暑假带孩子去海边一周""国庆7天云南路线"），自动推荐目的地、生成每日行程安排、匹配住宿与景点，并给出预算估算。此外，服务基于旅行场景知识库进行智能推荐，综合考虑出行时间、人群特征（亲子/蜜月/独行）、预算约束等因素，输出包含酒店推荐、景点安排、亮点说明及预订链接的完整行程方案。整个服务通过标准MCP协议交互，智能完成从需求理解、目的地推荐、行程生成到预订链接提供的完整服务流程，为旅行智能体搭建、AI编程助手集成及对话式旅行应用提供精准、高效的一站式旅行规划解决方案。

## 工具列表

### plan_travel - 旅行智能规划

根据自然语言需求智能规划旅行方案，涵盖酒店、景点、度假套餐和行程安排。

参数：
- `query`（必填）：用户的自然语言旅行需求，如："三亚度蜜月预算1万怎么安排""国庆7天去云南路线""周末广州亲子游预算2000"

## 安装

```bash
pip install mcp-travel-smart-plan
```

或使用 uvx 直接运行：

```bash
uvx mcp-travel-smart-plan
```

## 配置

需要设置以下环境变量：

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

### 在 MCP 客户端中配置

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

## 适用场景

- **AI编程助手**：在Cursor/Windsurf中直接调用旅行规划，为旅行项目提供智能方案
- **旅行智能体**：给旅行AI Agent接上规划能力，实现"需求→方案→预订"端到端闭环
- **对话式旅行应用**：自然语言输入即可获得完整行程方案，低延迟适配实时对话
- **与酒店/景点服务联动**：搭配酒店和景点MCP服务，构建"规划+预订"一站式旅行方案

## 技术特性

- 基于MCP（Model Context Protocol）标准
- 自然语言输入，无需结构化参数
- 综合考虑出行时间、人群特征、预算约束
- 返回包含酒店推荐、景点安排、预订链接的完整方案
- SSE流式响应支持

## License

MIT
