Labsco
MCP SERVER

Project Zomboid MCP Server

by wink-

Write Project Zomboid mod scripts that reference real items and balance against real vanilla numbers.

Games, Entertainment & Fandom
Summary
Balance checked against the vanilla item, not against a vibe.

The reason to index the game first is that every later answer is grounded: a generated weapon is compared to the real katana's damage and weight, and every referenced item, sound and sprite is confirmed to exist. That turns "this looks about right" into something the server can disagree with.

What it is

A TypeScript server that indexes the game's own script files into a searchable database, then generates, validates and analyses mod scripts against it. It detects Steam, Epic and GOG installations on Windows, Linux, macOS and WSL.

What you get
  • Vanilla content searched with type and category filters — search_vanilla
  • Scripts generated from templates and real game patterns, for items, recipes, evolved recipes, fixing, sounds and vehicles — generate_script
  • Script syntax and references validated, with a strict mode and detailed error reporting — validate_script
  • Item, sound and sprite references checked against the game database — check_references
  • A whole mod directory analysed for balance, compatibility and structure, with a report — analyze_mod
  • Game files parsed and indexed, with the installation path detected for you — parse_game_files
  • A Cloudflare Workers deployment path with D1 storage and an HTTP endpoint per tool
Requirements

Node.js 18.0.0 or higher. Clone the repository, npm install, npm run build, then point your client at dist/index.js. Run parse_game_files once to populate the database before the other tools have anything to check against. Deploying to Cloudflare needs Wrangler and a D1 database.