RPG Maker MZ MCP Server

Instructions

Implementation Reference

• src/game-creation-tools.ts:23-118 (handler)

  The core handler function that executes the 'create_project' tool logic. It creates the full RPG Maker MZ project directory structure, Game.rpgproject file, default System.json, MapInfos.json, Map001.json, and empty database JSON files.
  export async function createNewProject(projectPath: string, gameTitle: string) { try { // Validate inputs Validator.requireString(projectPath, "project_path"); Validator.requireString(gameTitle, "game_title"); await Logger.info("Creating new project", { projectPath, gameTitle }); // Check if project already exists try { await fs.access(projectPath); throw new Error(`Project path already exists: ${projectPath}`); } catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") { throw error; } } // Create directory structure const dirs = [ "audio/bgm", "audio/bgs", "audio/me", "audio/se", "data", "effects", "img/animations", "img/battlebacks1", "img/battlebacks2", "img/characters", "img/enemies", "img/faces", "img/parallaxes", "img/pictures", "img/sv_actors", "img/sv_enemies", "img/system", "img/tilesets", "img/titles1", "img/titles2", "js/plugins", "movies" ]; for (const dir of dirs) { await fs.mkdir(path.join(projectPath, dir), { recursive: true }); } // Create Game.rpgproject file const projectFile = `RPGMZ 1.0.0`; await fs.writeFile(path.join(projectPath, "Game.rpgproject"), projectFile, "utf-8"); // Create System.json const system = getDefaultSystem(gameTitle); await fs.writeFile( path.join(projectPath, "data", "System.json"), JSON.stringify(system, null, 0), "utf-8" ); // Create initial map const mapInfos = [null, getDefaultMapInfo(1, "MAP001")]; await fs.writeFile( path.join(projectPath, "data", "MapInfos.json"), JSON.stringify(mapInfos, null, 0), "utf-8" ); const map001 = getDefaultMap(1, "MAP001"); await fs.writeFile( path.join(projectPath, "data", "Map001.json"), JSON.stringify(map001, null, 0), "utf-8" ); // Create empty database files await fs.writeFile(path.join(projectPath, "data", "Actors.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Classes.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Skills.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Items.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Weapons.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Armors.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Enemies.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Troops.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "States.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Animations.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "Tilesets.json"), JSON.stringify([null], null, 0), "utf-8"); await fs.writeFile(path.join(projectPath, "data", "CommonEvents.json"), JSON.stringify([null], null, 0), "utf-8"); await Logger.info("Project created successfully", { projectPath }); return { success: true, message: `Project created at ${projectPath}` }; } catch (error) { await Logger.error("Failed to create project", { projectPath, gameTitle, error }); return createErrorResponse(error); } }
• src/index.ts:1145-1152 (registration)

  MCP server registration of the 'create_project' tool handler in the CallToolRequestSchema switch statement, which calls the createNewProject function.
  case "create_project": { const projectPath = args.project_path as string; const gameTitle = args.game_title as string; const result = await createNewProject(projectPath, gameTitle); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }
• src/index.ts:208-225 (schema)

  Input schema definition for the 'create_project' tool, provided in the ListToolsRequestSchema response.
  { name: "create_project", description: "Create a new RPG Maker MZ project from scratch", inputSchema: { type: "object", properties: { project_path: { type: "string", description: "Path where the project will be created", }, game_title: { type: "string", description: "Title of the game", }, }, required: ["project_path", "game_title"], }, },