RPG Maker MV Ultimate MCP MCP Server

Name: RPG Maker MV Ultimate MCP MCP Server
Author: io.github.DiegoLopez0208

io.github.DiegoLopez0208/rpgmaker-mv-ultimate

Repository Registry

What is the RPG Maker MV Ultimate MCP MCP server?

RPG Maker MV Ultimate: AI copilot to generate, edit and understand RPG Maker MV projects (MCP)

How to install RPG Maker MV Ultimate MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

RPGMAKER_PROJECT_PATH
Absolute path to the RPG Maker MV project to edit (the folder with data/ and js/). The server starts without it; needed for real editing, or call set_project_path at runtime.
VISION_API_URL
Base URL of an OpenAI-compatible vision endpoint to enable analyze_image mode "ai" (e.g. https://api.openai.com or http://localhost:11434). Unset = vision disabled; every other tool works offline.
VISION_API_KEY
secret
Bearer token for the vision endpoint (only sent when set).
VISION_MODEL
Vision model name to request (e.g. gpt-4o, llava). Defaults to meta/llama-3.2-90b-vision-instruct.
RPGMV_LEGACY_TOOLS
Set to 1 to also advertise the 101 legacy v4 tool names (they remain callable regardless of this flag).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rpgmaker-mv-ultimate": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "<YOUR_RPGMAKER_PROJECT_PATH>",
        "VISION_API_URL": "<YOUR_VISION_API_URL>",
        "VISION_API_KEY": "<YOUR_VISION_API_KEY>",
        "VISION_MODEL": "<YOUR_VISION_MODEL>",
        "RPGMV_LEGACY_TOOLS": "<YOUR_RPGMV_LEGACY_TOOLS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "rpgmaker-mv-ultimate": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "<YOUR_RPGMAKER_PROJECT_PATH>",
        "VISION_API_URL": "<YOUR_VISION_API_URL>",
        "VISION_API_KEY": "<YOUR_VISION_API_KEY>",
        "VISION_MODEL": "<YOUR_VISION_MODEL>",
        "RPGMV_LEGACY_TOOLS": "<YOUR_RPGMV_LEGACY_TOOLS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rpgmaker-mv-ultimate": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "<YOUR_RPGMAKER_PROJECT_PATH>",
        "VISION_API_URL": "<YOUR_VISION_API_URL>",
        "VISION_API_KEY": "<YOUR_VISION_API_KEY>",
        "VISION_MODEL": "<YOUR_VISION_MODEL>",
        "RPGMV_LEGACY_TOOLS": "<YOUR_RPGMV_LEGACY_TOOLS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "rpgmaker-mv-ultimate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "<YOUR_RPGMAKER_PROJECT_PATH>",
        "VISION_API_URL": "<YOUR_VISION_API_URL>",
        "VISION_API_KEY": "<YOUR_VISION_API_KEY>",
        "VISION_MODEL": "<YOUR_VISION_MODEL>",
        "RPGMV_LEGACY_TOOLS": "<YOUR_RPGMV_LEGACY_TOOLS>"
      }
    }
  }
}

Claude Code

claude mcp add rpgmaker-mv-ultimate --env RPGMAKER_PROJECT_PATH=<YOUR_RPGMAKER_PROJECT_PATH> --env VISION_API_URL=<YOUR_VISION_API_URL> --env VISION_API_KEY=<YOUR_VISION_API_KEY> --env VISION_MODEL=<YOUR_VISION_MODEL> --env RPGMV_LEGACY_TOOLS=<YOUR_RPGMV_LEGACY_TOOLS> -- npx -y rpgmaker-mv-mcp