# Disney Parks MCP Server
An MCP (Model Context Protocol) server that provides Disney parks data to Claude Code. Returns structured data for attractions, dining, and other park entities.
## Features
- **Attraction data**: Height requirements, Lightning Lane status, thrill levels, single rider availability
- **Dining data**: Service type, meal periods, cuisine, reservations, mobile ordering
- **Fuzzy search**: Find entities by name with intelligent matching
- **Auto-caching**: 24-hour cache with SQLite persistence
- **Dual data sources**: Disney Finder API (primary) with ThemeParks.wiki fallback
## Installation
```bash
npm install
npm run build
```
## Usage
### With Claude Code
Add to your Claude Code MCP configuration:
```json
{
"mcpServers": {
"disney": {
"command": "node",
"args": ["/path/to/mouse-mcp/dist/index.js"]
}
}
}
```
### Development
```bash
# Run in development mode with auto-reload
npm run dev
# Type check without building
npm run check
# Test with MCP inspector
npm run inspector
```
## Tools
### `disney_destinations`
List all supported Disney destinations with their parks.
```
No parameters required
```
### `disney_attractions`
Get attractions for a destination or park.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination` | string | Yes | `wdw` or `dlr` |
| `parkId` | string | No | Filter to specific park |
| `filters.hasLightningLane` | boolean | No | Only Lightning Lane attractions |
| `filters.maxHeightRequirement` | number | No | Max height in inches |
| `filters.thrillLevel` | string | No | `family`, `moderate`, or `thrill` |
| `filters.hasSingleRider` | boolean | No | Only single rider attractions |
### `disney_dining`
Get dining locations for a destination or park.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination` | string | Yes | `wdw` or `dlr` |
| `parkId` | string | No | Filter to specific park |
| `filters.serviceType` | string | No | `table-service`, `quick-service`, etc. |
| `filters.mealPeriod` | string | No | `breakfast`, `lunch`, `dinner`, `snacks` |
| `filters.reservationsAccepted` | boolean | No | Only reservation restaurants |
| `filters.characterDining` | boolean | No | Only character dining |
### `disney_entity`
Look up a specific entity by ID or fuzzy name search.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No* | Entity ID for exact lookup |
| `name` | string | No* | Entity name for fuzzy search |
| `destination` | string | No | Limit search to `wdw` or `dlr` |
| `entityType` | string | No | `ATTRACTION` or `RESTAURANT` |
*Either `id` or `name` is required.
### `disney_status`
Get server health and cache statistics.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `includeDetails` | boolean | No | Include entity breakdown |
## Configuration
Environment variables (all prefixed with `MOUSE_MCP_`):
| Variable | Default | Description |
|----------|---------|-------------|
| `MOUSE_MCP_LOG_LEVEL` | `INFO` | Log level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
| `MOUSE_MCP_DB_PATH` | `~/.cache/mouse-mcp/disney.db` | SQLite database path |
| `MOUSE_MCP_TIMEOUT` | `30000` | Request timeout in ms |
| `MOUSE_MCP_HEADLESS` | `true` | Run Playwright in headless mode |
## Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ MCP Server │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Tools │ │
│ │ destinations | attractions | dining | entity | status │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ API Clients │ │
│ │ ┌─────────────────┐ ┌─────────────────┐ │ │
│ │ │ Disney Finder │───▶│ ThemeParks.wiki │ │ │
│ │ │ (primary) │ │ (fallback) │ │ │
│ │ └─────────────────┘ └─────────────────┘ │ │
│ │ │ │ │
│ │ ┌─────────────────┐ │ │
│ │ │ Session Manager │ (Playwright auth) │ │
│ │ └─────────────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ SQLite Database │ │
│ │ sessions | cache | entities (with FTS5) │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```
## Supported Destinations
### Walt Disney World Resort (wdw)
- Magic Kingdom Park
- EPCOT
- Disney's Hollywood Studios
- Disney's Animal Kingdom Theme Park
### Disneyland Resort (dlr)
- Disneyland Park
- Disney California Adventure Park
## License
MIT
