pz

Project Zomboid MCP Server (pz-mcp-server) provides AI-assisted tooling for mod development, script generation, validation, and data access against the vanilla game when building Project Zomboid mods. It exposes a suite of MCP tools such as search_vanilla, generate_script, validate_script, check_references, analyze_mod, and parse_game_files, enabling you to locate vanilla content, create balanced mod scripts, verify syntax and references, analyze mod quality, and index game data for fast lookups. The server is designed to auto-detect installations, support cross-platform environments, and integrate with Cloudflare Workers for deployment, making it versatile for local development and cloud-backed workflows. To use it, connect your IDE or Claude Desktop configuration to the MCP endpoint and invoke tools via the provided API to search content, generate new items or recipes, validate your scripts, and cross-check references against the game database. You can also parse vanilla game files to ensure your local dataset is current and aligned with the latest game structure.

Prerequisites:

• Node.js 18.0.0 or higher
• npm or yarn

Local development setup:

1. Clone the repository git clone https://github.com/minimax/pz-mcp-server.git cd pz-mcp-server

2. Install dependencies npm install

3. Build the project npm run build

4. Run in development mode npm run dev

Cloudflare Workers deployment (optional):

1. Install Wrangler CLI npm install -g wrangler

2. Login to Cloudflare wrangler login

3. Create a D1 database for your deployment wrangler d1 create pz-mcp-prod

4. Deploy to Cloudflare Workers wrangler deploy

Notes and tips:

• The server is Node.js-based; the recommended deployment in Claude Desktop examples uses the Node runtime with the built dist/index.js entry.
• The mcp_config example shows how to wire the server in the MCP ecosystem; adjust the path to your built server accordingly.
• If you enable Cloudflare Workers, configure wrangler.toml environment bindings for the D1 database and KV storage to ensure full API capabilities and caching.
• The MCP tools functionality includes real-time validation, reference checks, and balance analysis; ensure your local dataset is up to date by running parse_game_files regularly.
• For development workflows, you can initialize the database, parse vanilla game files, then start making and validating mod assets iteratively with generate_script and validate_script.
• If you encounter environment-related issues, verify that your Node.js version matches the minimum requirement and that the dist/index.js file exists after building.