Metadata-Version: 2.4
Name: mcp-shanghai-disney
Version: 0.1.1
Summary: Shanghai Disneyland MCP Service - Real-time wait times, smart recommendations, show schedules, and route planning
Author: Jun Ma
License-Expression: MIT
License-File: LICENSE
Keywords: ai-tools,amusement-park,disney,mcp,shanghai-disneyland,travel
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.9.2
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Shanghai Disneyland MCP Service

专注上海迪士尼乐园的智能游园MCP服务，为AI助手、旅行智能体及Cursor/Cherry Studio/Windsurf等IDE提供实时排队、智能推荐、演出时间、路线规划等游园辅助能力。

## Features

- **实时排队查询** - 获取园区31个游乐设施的实时等待时间
- **智能推荐** - 基于用户画像和实时数据智能推荐下一步
- **演出时间表** - 15个演出场次时间及观赏建议
- **路线规划** - 一日游完整行程规划
- **营业时间** - 近期营业时间查询
- **餐厅推荐** - 园区20+餐厅美食推荐
- **门票价格** - 各类门票价格及购票建议

## MCP Tools

### disney_ticket - 门票价格查询
查询上海迪士尼门票价格和类型。

**参数：**
- `date` (可选): 游览日期，YYYY-MM-DD格式，默认今天
- `query` (可选): 查询关键词，如"2成人1儿童"

---

### disney_wait_times - 实时排队时间
查询游乐设施实时排队等待时间。

**参数：**
- `query` (可选): 筛选条件，如"刺激项目"、"室内项目"、"梦幻世界"

---

### disney_show_schedule - 演出时间表
查询园区演出场次时间及观赏建议。

**参数：**
- `date` (可选): 日期，YYYY-MM-DD格式
- `query` (可选): 筛选条件，如"必看"、"需预约"

---

### disney_smart_next - 智能推荐下一步（核心工具）
根据当前情况智能推荐最佳下一步游玩项目。

**参数：**
- `query` (可选): 自然语言描述当前状况，如：
  - "带5岁孩子"
  - "2大人1小孩8岁"
  - "刚玩完创极速光轮"
  - "刺激路线"
  - "亲子游"

---

### disney_route - 路线规划
规划上海迪士尼一日游完整路线。

**参数：**
- `query` (可选): 路线类型，如"亲子一日游"、"刺激路线"

---

### disney_schedule - 营业时间查询
查询上海迪士尼近期营业时间。

**参数：**
- `days` (可选): 查询天数，默认7天，最多14天

---

### disney_dining - 园区餐厅查询
查询园区餐厅和美食推荐。

**参数：**
- `query` (可选): 筛选条件，如"梦幻世界餐厅"、"便宜的小食"、"烧烤"

---

## Applicable Scenarios

- 🗣️ AI对话助手 - 智能解答游园问题
- 🤖 旅行智能体 - 自动化行程规划
- 💻 IDE集成 - Cursor/Cherry Studio/Windsurf等MCP兼容编辑器
- 📱 移动端 - 微信/飞书等平台机器人
- 🎮 游戏化 - 结合LBS的游戏化体验

## Installation

```bash
pip install mcp-shanghai-disney
```

## Configuration

### Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `GAODE_API_KEY` | No | 内置兜底Key | 高德地图API Key，用于获取营业时间 |

### MCP Client Configuration

#### Cursor
```json
{
  "mcpServers": {
    "shanghai-disney": {
      "command": "uvx",
      "args": ["mcp-shanghai-disney"]
    }
  }
}
```

#### Cherry Studio
```json
{
  "mcpServers": {
    "shanghai-disney": {
      "command": "uvx",
      "args": ["mcp-shanghai-disney"]
    }
  }
}
```

#### Windsurf
```json
{
  "mcpServers": {
    "shanghai-disney": {
      "command": "uvx",
      "args": ["mcp-shanghai-disney"]
    }
  }
}
```

#### Claude Desktop
```json
{
  "mcpServers": {
    "shanghai-disney": {
      "command": "uvx",
      "args": ["mcp-shanghai-disney"],
      "env": {
        "GAODE_API_KEY": "your_key_here"
      }
    }
  }
}
```

## Usage Example

```
User: 带5岁孩子去迪士尼，推荐一下
Agent: 调用 disney_smart_next(query="带5岁孩子")
-> 返回针对5岁孩子的智能推荐

User: 现在各个项目排队多久？
Agent: 调用 disney_wait_times()
-> 返回实时排队时间

User: 明天带家人去，想看演出
Agent: 调用 disney_route(query="亲子一日游") + disney_show_schedule(date="明天")
-> 返回完整路线和演出时间
```

## Data Coverage

- 🏰 **31个游乐设施** - 涵盖刺激、温和、室内、室外等全类型
- 🎭 **15个演出** - 包括必看演出和特色表演
- 🍽️ **20+餐厅** - 中西餐、快餐、小食全覆盖
- 📍 **7大主题园区** - 明日世界、梦幻世界、探险岛等

## License

MIT License - © 2024 Jun Ma
