sh-disney

sh-disney-mcp is an MCP server that provides standardized endpoints to query Shanghai Disneyland ticket information, including one-day and two-day tickets, with both price and sale-availability data. The server exposes helper tools such as getOneDayTicketSaleInfo, getOneDayTicketPrice, getTwoDayTicketSaleInfo, and getTwoDayTicketPrice. These tools enable a large language model or automated agent to fetch current or future ticket details by date. To use the MCP server, initialize the server via the MCP host configuration, then invoke the available tools by date (for price queries) or by default (for sale information). The provided functions return human-readable text that summarizes ticket status and pricing, suitable for inclusion in planning prompts or direct display to end users.

Prerequisites:

• Node.js 16.x or higher
• npm or pnpm package manager

Installation steps:

1. Clone the repository and navigate to the project directory:

git clone [repository-url]
cd sh-disney-mcp

2. Install dependencies using pnpm (or npm/yarn if preferred):

pnpm install

3. Build the project:

pnpm run build

4. Run local inspection/debug (optional):

pnpm run inspect

5. Start the MCP server (via MCP host integration example):

# Depending on your setup, you may start the server directly or via the MCP host config
# Example using npx as shown in the MCP config:
npx -y sh-disney-mcp

Notes:

• The MCP server relies on the sh-disney-mcp npm package. Ensure network access to the package registry when installing.
• If you encounter build failures, ensure your Node.js version matches the project’s target (16.x+ recommended) and your environment has necessary build tools.
• The toolset includes getOneDayTicketSaleInfo, getOneDayTicketPrice, getTwoDayTicketSaleInfo, and getTwoDayTicketPrice. Pass dates in the specified format (YYYY-MM-DD) for price queries.
• No extra environment variables are strictly required, but you can set NODE_ENV and other standard Node.js runtime variables as needed for your deployment environment.