The RPGMakerUltimate-MCP server provides comprehensive tools to manage and create RPG Maker MV game projects across these areas:

Database Management Create, read, update, delete, and search actors, classes, skills, items, weapons, armors, enemies, states, troops, common events, animations, and tilesets. Includes simplified builders for damage/healing skills, boss enemies, and random encounter troops.

Map Management

• Create blank, themed, template-based (106 bundled templates), or procedurally generated maps (Perlin noise, BSP dungeon, cellular automata across 21 themes)

• Batch map generation, duplication, validation (detects invalid tile IDs, broken event commands, null references)

• Edit tile layers, set display names, organize map tree hierarchy

• Connect maps with bidirectional transfer events

• Render maps as offline ASCII art with event markers and region IDs

Event Creation

• Full CRUD for map events and low-level event command insertion

• High-level builders for NPCs (multi-page dialogue), treasure chests, teleporters, shops, inns, boss battles, and puzzle switch/door pairs

• Bulk populate maps with NPCs, chests, or bosses at random positions

System Settings Get/update game title, switch/variable names, player starting position, and full System.json data.

Project Management

• Project summaries, full context digests (tilesets, maps, actors, items, switches, variables, sprites)

• Asset scanning to index images and tile metadata

• Tile ID categorization (ground, water, wall, roof, decoration) per tileset

• Runtime project switching without restarting the server

Image & Vision Analysis

• Send project images (tilesets, sprites, screenshots, battlers, faces) to any OpenAI-compatible vision API for AI descriptions

• Offline tileset grid analysis and screenshot quadrant color extraction (no API required)

Enables AI-driven analysis of project images (tilesets, screenshots, etc.) using NVIDIA's vision models via the analyze_screenshot tool.

Enables AI-driven analysis of project images (tilesets, screenshots, etc.) using Ollama's vision models via the analyze_screenshot tool.

Enables AI-driven analysis of project images (tilesets, screenshots, etc.) using OpenAI's vision models via the analyze_screenshot tool.

npm install
npm run build
RPGMAKER_PROJECT_PATH=/path/to/your/project npm start

{
 "mcpServers": {
 "rpgmaker-mv": {
 "command": "node",
 "args": ["/path/to/RpgMakerMVUltimate-MCP/dist/index.js"],
 "env": {
 "RPGMAKER_PROJECT_PATH": "/path/to/your/project"
 }
 }
 }
}

{
 "tool": "analyze_screenshot",
 "arguments": {
 "image_path": "img/tilesets/Outside.png",
 "prompt": "Describe the tile categories and colors",
 "resize_max": 1024
 }
}

VISION_API_URL=https://api.openai.com \
VISION_API_KEY=sk-... \
VISION_MODEL=gpt-4o \
npm start

VISION_API_URL=http://localhost:11434 \
VISION_MODEL=llava \
npm start

{
 "tool": "render_map_ascii",
 "arguments": {
 "map_id": 1,
 "layer": 0,
 "show_events": true,
 "show_regions": false
 }
}

{
 "tool": "create_map",
 "arguments": {
 "name": "Dark Forest",
 "width": 30,
 "height": 25,
 "tilesetId": 2,
 "theme": "forest",
 "displayName": "The Dark Forest"
 }
}

{
 "tool": "create_map",
 "arguments": {
 "templateId": 1,
 "displayName": "Custom Forest"
 }
}

{ "tool": "scan_project_assets" }

npm install
npm run build # tsc compile
npm start # run built server
npm run dev # tsx watch mode for development

src/
 server.ts # MCP server entry point (tool dispatch + handlers)
 index.ts # Re-export entry
 types/
 rpgmaker.ts # Shared TypeScript interfaces for all MV data structures
 tools/
 actorTools.ts # Actor CRUD
 animationTools.ts # Animation get
 assetTools.ts # Asset scanning + tile ID categorization
 classTools.ts # Class CRUD
 commonEventTools.ts # Common event CRUD
 enemyTools.ts # Enemy CRUD + boss builder
 itemTools.ts # Item/Weapon/Armor CRUD
 mapTools.ts # Map CRUD + event builders + generation integration
 projectTools.ts # Project summary + path switch
 skillTools.ts # Skill CRUD + simplified builders
 stateTools.ts # State CRUD
 systemTools.ts # System switches/variables/title
 tilesetTools.ts # Tileset get/update
 troopTools.ts # Troop CRUD + encounter builder
 utils/
 fileHandler.ts # readJson/writeJson/nextId/getMapPath
 commandBuilder.ts # Event command factory (35+ commands)
 mapGenerator.ts # Unified generator (Perlin, BSP, cellular, 21 themes)
 logger.ts # Logging utility
 knowledge/
 mapTemplates.ts # Template index loading + search
knowledge/
 maps/ # 106 ProjectR reference map JSONs
 map-templates.json # Template index
 tile-ids.json # Tile ID ranges and formulas
 passage-flags.json # Passage flag bits
 event-commands.json # Event command reference
 enums.json # Enum value reference
 trait-effect-codes.json # Trait and effect codes
 database-schemas.json # MV data type schemas
 image-paths.json # Image path conventions