convez.ai
MCP ServerDesenvolvimento WebAvançado
DiegoLopez0208

RPG Maker MV Ultimate MCP

DiegoLopez0208/RpgMakerMVUltimate-MCP

102 ferramentas para desenvolver RPG Maker MV com IA e procedural

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP com 102 ferramentas para gerenciamento completo de projetos RPG Maker MV, incluindo geração procedural de mapas com IA, análise de screenshots com visão computacional e renderização offline de mapas em ASCII. Oferece builders de eventos, validação de projetos e escaneamento inteligente de assets.

Instalação

$npx convez-ai DiegoLopez0208/RpgMakerMVUltimate-MCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
32
Forks
4
Acompanhando
0
Saúde
57%
Último commit
há 1 mês
Versão
v5.21.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Geração automática e inteligente de mapas com temas procedurais
  • Gerenciamento CRUD de atores, skills, itens, inimigos e estados
  • Análise visual de screenshots de projeto com IA vision
  • Criação de eventos complexos (NPCs, chests, shops, boss battles)
  • Validação e limpeza de projetos RPG Maker MV

Veredito

MCP extremamente robusto e especializado para RPG Maker MV — 102 ferramentas bem estruturadas cobrem praticamente todo ciclo de desenvolvimento. A combinação de geração procedural de mapas, visão AI e builders de eventos o torna único; porém requer familiaridade tanto com RPG Maker MV quanto com MCP servers para aproveitar plenamente.

README

A tradução para o português deste README ainda está na fila.

RPG Maker MV Ultimate MCP Server

A Model Context Protocol server for RPG Maker MV project management. Provides 102 tools for actors, classes, skills, items, weapons, armors, enemies, states, troops, common events, maps, events, tilesets, animations, system settings, project management, AI vision analysis, offline ASCII map rendering, and knowledge-driven map generation.

Features

  • 102 MCP tools covering every aspect of RPG Maker MV project data
  • TypeScript ESM — fully typed codebase with strict compilation.
  • Vision AI analysis — analyze_screenshot sends project images to any OpenAI-compatible vision API (OpenAI, Ollama, LocalAI, NVIDIA, etc.) for AI descriptions
  • Offline ASCII map rendering — render_map_ascii generates ASCII maps with event markers and region IDs, no API needed
  • Knowledge-driven map generation with 21 themes, procedural generation (Perlin noise, BSP, cellular automata), and 106 template maps
  • Template-based map generation — generates maps from ProjectR reference templates
  • Asset scanning — indexes your project's img/ folder and Tilesets.json to build categorized tile inventories
  • 7 static knowledge files — tile IDs, passage flags, event commands, enums, trait/effect codes, database schemas, image paths
  • High-level event builders — NPC with dialogue, chest, teleport, shop, inn, boss battle, puzzle switch, transfer
  • Map validation — detects invalid tile IDs, broken event commands, null references
  • 21 procedural themes — forest, town, village, castle, dungeon, cave, beach, desert, swamp, ruins, interior, snow, harbor, volcano, sewer, fortress, magic_forest, magic_interior, space_interior, space_exterior, world

Quick Start

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

With Claude Desktop / opencode / any MCP client

Add to your MCP config:

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

Tool Categories

CategoryToolsDescription
Actor6CRUD, search, delete
Item/Weapon/Armor6CRUD, search, delete
Skill9Full + simplified builders (damage, healing, buff, state), CRUD
Class6CRUD, search, delete
Enemy7CRUD, boss builder, search, delete
State6CRUD, search, delete
Map15CRUD, fill layer, events, search, delete, duplicate
Event Helpers8NPC, chest, teleport, shop, inn, boss, puzzle switch, transfer
Tileset3Get, update
Common Event4CRUD, add command
Troop5CRUD, add enemy, random encounter builder
Animation2Get, get by ID
System8Switches, variables, game title, starting position
Project4Summary, context, validate map, set path
Asset2Scan project assets, get tile IDs for tileset
Vision AI2AI screenshot analysis (OpenAI-compatible), ASCII map render
Image2Tileset dimension analysis, screenshot quadrant analysis

Vision AI

The analyze_screenshot tool sends project images to an OpenAI-compatible vision API for AI-powered analysis. Works with any endpoint that supports the /v1/chat/completions API format.

Supported backends: OpenAI, Ollama, LocalAI, NVIDIA NIM, vLLM, LiteLLM, or any OpenAI-compatible proxy.

Configuration

Set these environment variables to enable vision analysis:

VariableDefaultDescription
VISION_API_URLhttp://127.0.0.1:9999Base URL of the vision API
VISION_API_KEYsk-proxyAPI key / bearer token
VISION_MODELmeta/llama-3.2-90b-vision-instructModel name to use
VISION_API_PATH/v1/chat/completionsAPI endpoint path

Usage

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

Works with: tilesets, character sprites, map screenshots, battlers, faces, etc.

OpenAI Example

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

Ollama Example

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

Without Vision AI

Set no VISION_API_URL or leave it unset. All other 100 tools work offline. render_map_ascii provides visual map inspection without any API.

render_map_ascii

Generates an ASCII representation of a map. No API required — works offline.

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

Output uses tileset flag-based characters: . empty, ~ water, # wall, H ladder, " bush, , terrain, T tree, D decoration, A autotile. Event positions shown as first-letter markers.

Map Generation

The unified map generator produces coherent, beautiful maps using your project's actual tilesets:

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

Themes

forest town village castle dungeon cave beach desert swamp ruins interior snow harbor volcano sewer fortress magic_forest magic_interior space_interior space_exterior world

Template-Based Generation

Generate maps from 106 Rpg maker MV reference templates:

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

How It Works

  1. create_map calls get_tile_ids_for_tileset to read the tileset's actual tiles
  2. Categories tiles into: ground, water, wallSide, wallTop, roof, decoration
  3. Generates a 6-layer map: z=0,1 (ground), z=2,3 (upper), z=4 (shadow bits), z=5 (region ID)
  4. Falls back to hardcoded RTP IDs if tileset scan fails (backward compatible)
  5. Procedural generators use Perlin noise, BSP tree partitioning, and cellular automata

Asset Scanning

{ "tool": "scan_project_assets" }

Returns tileset sheet metadata (dimensions, tile counts, autotile kinds), categorized available tiles, and all PNG files in img/ subdirectories.

Knowledge Base

Static JSON files in knowledge/ provide technical reference data extracted from the RPG Maker MV corescript:

FileContent
tile-ids.jsonTile ID ranges, autotile formula, sheet descriptions
passage-flags.jsonFlag bits, common flags, passage check logic
event-commands.json~140 event command codes with parameter schemas
enums.jsonScope, occasion, hitType, damageType, restriction, etc.
trait-effect-codes.jsonTrait codes 11-64, effect codes 11-45
database-schemas.jsonFull schemas for all MV data types
image-paths.jsonimg/ directories, tileset slots, naming conventions

See knowledge/README.md for details.

Development

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

Project Structure

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

[

DiegoLopez0208/RpgMakerMVUltimate-MCP MCP server

](https://glama.ai/mcp/servers/DiegoLopez0208/RpgMakerMVUltimate-MCP)

License

MIT

Ver o original no GitHub

Bom para

Relacionados