RPG Maker MV Ultimate MCP Server

by diegolopez0208io.github.DiegoLopez0208/rpgmaker-mv-ultimatev5.20.0

Offline RPG Maker MV assistant: generate maps, edit the database and events, validate broken references, debug events and search a project semantically.

26Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install RPG Maker MV Ultimate MCP server

claude mcp add rpgmaker-mv -e VISION_API_KEY='<vision-api-key>' -- npx -y rpgmaker-mv-mcp

{
  "mcpServers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "VISION_API_KEY": "<vision-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "VISION_API_KEY": "<vision-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "rpgmaker-mv": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "VISION_API_KEY": "<vision-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "VISION_API_KEY": "<vision-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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	—	yes	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).

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-10-07 · 2d ago · GitHub · v5.20.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v5.20.0

FAQ

›How do I install the RPG Maker MV Ultimate MCP server in Claude Code?

Run: claude mcp add rpgmaker-mv -e VISION_API_KEY='<vision-api-key>' -- npx -y rpgmaker-mv-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does RPG Maker MV Ultimate require an API key?

Yes. It expects VISION_API_KEY, of which 1 is a secret.

›Can I use RPG Maker MV Ultimate as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is RPG Maker MV Ultimate in the official MCP registry?

Yes, as io.github.DiegoLopez0208/rpgmaker-mv-ultimate.