RPG Maker MZ MCP Server

Instructions

Implementation Reference

• src/scenario-generation.ts:323-335 (handler)

  Core handler function that generates multiple scenario variations by calling generateScenarioWithGemini in a loop for the specified count.
  export async function generateScenarioVariations( request: ScenarioGenerationRequest, count: number ): Promise<Array<{ success: boolean; scenario?: GeneratedScenario; error?: string }>> { const results = []; for (let i = 0; i < count; i++) { const result = await generateScenarioWithGemini(request); results.push(result); } return results; }
• src/index.ts:1327-1340 (registration)

  MCP server handler registration: parses arguments, constructs ScenarioGenerationRequest, calls the core generateScenarioVariations function, and returns JSON results.
  case "generate_scenario_variations": { const request: ScenarioGenerationRequest = { projectPath: args.project_path as string, theme: args.theme as string, style: args.style as string, length: args.length as "short" | "medium" | "long", apiKey: args.api_key as string | undefined, }; const count = args.count as number; const results = await generateScenarioVariations(request, count); return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }], }; }
• src/index.ts:633-667 (schema)

  Tool schema definition in the MCP tools list, including input schema with properties matching ScenarioGenerationRequest plus count.
  { name: "generate_scenario_variations", description: "Generate multiple variations of a scenario for comparison", inputSchema: { type: "object", properties: { project_path: { type: "string", description: "Path to the RPG Maker MZ project directory", }, theme: { type: "string", description: "Theme or genre", }, style: { type: "string", description: "Style or tone", }, length: { type: "string", enum: ["short", "medium", "long"], description: "Length of scenarios", }, count: { type: "number", description: "Number of variations to generate", }, api_key: { type: "string", description: "Gemini API key (optional)", }, }, required: ["project_path", "theme", "style", "length", "count"], }, },
• src/scenario-generation.ts:21-27 (schema)

  TypeScript interface defining the input parameters for scenario generation functions, used by the handler.
  export interface ScenarioGenerationRequest { projectPath: string; theme: string; style: string; length: "short" | "medium" | "long"; apiKey?: string; }