mouse-mcp

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

npm install
npm run build

Usage

With Claude Code

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "disney": {
      "command": "node",
      "args": ["/path/to/mouse-mcp/dist/index.js"]
    }
  }
}

Development

# 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