Pz MCP Server

MCP Server for Project Zomboid mod development

Local serverstdioTypeScript

What is the Pz MCP server?

Connect Pz to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP Server for Project Zomboid mod development. The pz mcp server is what makes that connection.

What the server does

A comprehensive Model Context Protocol (MCP) server for Project Zomboid mod development, providing intelligent script validation, generation, and contextual assistance through AI-enhanced tooling.

  • D1 Database — for persistent storage
  • KV Storage — for caching frequently accessed data
  • HTTP API — endpoints for all MCP tools
  • Automatic scaling — with zero cold starts
  • Global edge deployment — for low latency

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • search_vanilla — Search vanilla Project Zomboid content with intelligent matching
  • generate_script — Generate balanced Project Zomboid scripts using templates and game data
  • validate_script — Validate Project Zomboid script syntax and references with detailed error reporting
  • check_references — Validate item, sound, and sprite references against game database
  • analyze_mod — Comprehensive analysis of mod directory including balance, compatibility, and structure validation
  • parse_game_files — Parse and index Project Zomboid game files to populate the database
  • Features — The Features tool exposed by this server
  • Configuration — The Configuration tool exposed by this server

Credentials and setup notes

  • Node.js 18.0.0 or higher - npm or yarn package manager

Installation

The server ships on npm as wrangler, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Pz's toolset — Prerequisites, search_vanilla, generate_script and 6 more — is a fair guide to whether it matches your workflow. It is maintained by wink-; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Pz.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
search_vanillaSearch vanilla Project Zomboid content with intelligent matching.
generate_scriptGenerate balanced Project Zomboid scripts using templates and game data.
validate_scriptValidate Project Zomboid script syntax and references with detailed error reporting.
check_referencesValidate item, sound, and sprite references against game database.
analyze_modComprehensive analysis of mod directory including balance, compatibility, and structure validation.
parse_game_filesParse and index Project Zomboid game files to populate the database.
FeaturesThe Features tool exposed by this server.
ConfigurationThe Configuration tool exposed by this server.

How to install the Pz MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18.0.0 or higher - npm or yarn package manager

Example prompts to try

  • Use Pz to Prerequisites.
  • Use Pz to search vanilla.
  • Use Pz to generate script.

Frequently asked questions

It connects Pz to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (Prerequisites, search_vanilla, generate_script, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Pz directly.