RPG Maker MV Ultimate MCP

社区

面向 RPG Maker MV 的 AI 副驾驶：生成地图、编辑数据库与事件，并能理解你的项目。

分类: 开发工具第 147 / 438
Stars: ★ 27 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 可选 API Key
许可证: MIT
最近提交: 11 天前
工具数: 13

58FMRS · C

该服务器扩展了 MCP 生态至 RPG Maker MV，提供独特的基于模板的地图生成和项目智慧分析。13 个工具覆盖 CRUD、地图编辑、事件管理和系统操作。亮点是知识驱动的地图生成（克隆模板）、只读项目分析（验证、解释、审查、重构）和可选视觉 AI。安装通过 npx，简单。有风险但提供备份和 dryRun。适合游戏开发者，但需注意备份和视觉 AI 端点配置。

最强项 · 文档质量 14/20 最弱项 · 维护活跃度 9/20

可靠性

10/20

安全与权限

12/20

维护活跃度

9/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 描述了原子写入、备份、dryRun、lint/validate 等受控失败路径，并提及 vitest 与源码结构，但未提供实际可核验的 CI 工作流或提交的测试覆盖证据；静态校准规定无此类证据不得高于 12，且未见错误处理细节，扣至 10。
安全与权限 12/20: VISION_API_KEY 标记为 secret 且仅设置时发送，vision 默认关闭，写入有备份与 dryRun；但服务器拥有对任意磁盘项目的完全读写、可执行 playtest/open_editor（进程启动）、scaffold_project 目录写入，未见危险操作确认机制或权限范围说明，扣分。
维护活跃度 9/20: 版本 5.16.1 已发布至 npm，MIT 许可，开放 issue 0，README 有反馈渠道；但 12 星、无可见的安全响应渠道或治理信息，版本迭代频繁但缺乏发布治理证据，扣分。
文档质量 14/20: 文档分层详尽：安装、环境变量表、13 工具表、各视图用法示例、已知限制与路线图、知识库说明，质量高于一般；但全部为 README 自述（不可信证据），未见独立排障文档，部分行为依赖隐藏环境变量（RPGMV_BACKUP_KEEP、VISION_API_PATH），扣至 14。
安装易用性 13/20: 提供 npx 单步安装与 Claude Desktop/Code、opencode 配置示例，无需构建即可运行，缺省环境变量均可选；但 playtest/open_editor 依赖本地 RPG Maker 安装路径（Windows 默认路径），跨平台兼容性说明不足，静态校准上限 15，扣至 13。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

使用 RPG Maker MV 的游戏开发者
希望用 AI 加速关卡设计的场景
需要通过 MCP 与项目交互的 AI 代理

不适合谁

非 RPG Maker MV 项目
需要可视化编辑器的实时同步（此工具直接改文件，非 GUI）
期望无需额外配置就能使用视觉 AI 能力的用户

所需权限

读写项目文件（data/ 和 js/）
运行项目（playtest）或打开编辑器
网络访问（可选，仅用于视觉 AI）

风险与副作用

误操作可能破坏项目数据，但有备份机制
使用视觉 AI 时会将图像发送到配置的端点
程序化生成可能不符合设计意图

安装接入

准备工作

运行环境：Node.js

VISION_API_KEY 可选密钥视觉端点的 Bearer 令牌（仅设置时发送），可在 OpenAI 等服务商处获取。

其他可选配置项（7 个）

RPGMAKER_PROJECT_PATH 可选要编辑的 RPG Maker MV 项目的绝对路径（含 data/ 和 js/）；服务器可不设启动，运行时用 set_project_path 指定。

VISION_API_URL 可选 OpenAI 兼容视觉端点的 Base URL（如 https://api.openai.com 或 http://localhost:11434）；不设则 analyze_image 的 AI 模式禁用。

VISION_MODEL 可选视觉模型名（默认 meta/llama-3.2-90b-vision-instruct），如 gpt-4o 或 llava。

VISION_API_PATH 可选视觉端点路径，默认 /v1/chat/completions。

RPGMV_LEGACY_TOOLS 可选设为 1 时额外注册 101 个 v4 旧版工具名。

RPGMV_BACKUP_KEEP 可选 .mcp-backups/ 中保留的备份份数，默认 10。

RPGMAKER_MV_INSTALL 可选 RPG Maker MV 安装目录，用于 playtest / open_editor；也可用默认 Steam 路径。

通过 npm 安装：在 MCP 客户端配置中添加服务器，设置 RPGMAKER_PROJECT_PATH 环境变量为项目路径。无需克隆仓库。可通过 npx 运行。

claude_desktop_config.json

{
  "mcpServers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "/path/to/your/RPGMakerMV/project"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "-y",
        "rpgmaker-mv-mcp"
      ],
      "env": {
        "RPGMAKER_PROJECT_PATH": "/path/to/your/RPGMakerMV/project"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add rpgmaker-mv -e RPGMAKER_PROJECT_PATH=/path/to/your/RPGMakerMV/project -- npx -y rpgmaker-mv-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应能看到 13 个工具（如 query_database、generate_map、analyze_project）；可让 AI 调用 analyze_project { view: "overview" }，若返回项目统计信息即连接成功。

常见排障

确保 RPGMAKER_PROJECT_PATH 正确指向项目文件夹（含 data 和 js）
若视觉功能不工作，检查 VISION_API_URL、VISION_API_KEY、VISION_MODEL 设置
写入操作失败时检查备份目录 .mcp-backups/
运行 playtest 需找到引擎安装位置（通过 install 或默认 Steam 路径）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

先给我这个项目的 overview，看看有哪些地图无法从起点到达。
用 generate_map 生成一张名为 Riverbend 的 40x30 town 地图。
解释一下为什么开关 12 从来没被触发过。
在 3 号地图上创建一个 chest 事件，然后打开游戏试运行。

工具能力 13

query_database 只读

列出、按 ID 获取或搜索任何数据库（角色、职业、技能、物品、武器、防具、敌人、状态、队伍、图块组、公共事件、动画）。

create_database_entry 写入

创建新条目，支持预设：伤害技能、治疗技能、增益技能、状态技能、Boss 敌人、遭遇队伍。

update_database_entry 写入

部分更新条目（包括队伍和动画）；向公共事件追加指令；向队伍添加敌人。

delete_database_entry 破坏性

删除条目（包括队伍和动画），并给出引用破坏警告。

query_map 只读

地图树、完整地图数据、事件、单个事件、检查（验证）、离线 ASCII 渲染。

generate_map 写入

知识驱动的地图生成：按主题克隆真实参考地图，或纯程序化、空白、主题化、特定模板、批量、复制。

edit_map 写入

填充图块层、设置显示名称、组织地图树、连接两幅地图、设置遇敌。

manage_map_event 写入

创建（支持预设：NPC、宝箱、传送、门、商店、旅店、Boss、拼图开关）、更新、转换现有事件为商人/旅店/标牌、删除、添加指令、批量填充。

展开其余 5 个工具

manage_system 写入

管理游戏标题、开关/变量名称、起始位置；编写插件、搭建新项目、运行游戏或打开编辑器。

analyze_project 只读

只读项目智慧：概览、索引、验证、图表、用法、解释、AST、插件、审查、重构、搜索。

get_project_context 只读

项目摘要、资源索引、各图块组 tile ID、内置模板目录。

set_project_path 写入

运行时切换项目。

analyze_image 只读

可选的视觉 AI 图像分析，及离线图块网格测量和象限颜色。

使用场景

从文本描述生成完整、可玩的地图（城镇、地牢等）。

通过自然语言创建 NPC、商店、传送点、Boss 事件。

分析项目一致性，查找断链引用、不可达地图。

解释为什么某个事件（如门）从不触发。

设计审查地图：死区、拥挤、事件分布。

快速搭建新项目或编写插件。

支持客户端

Claude Desktop

Claude Code

OpenCode

依据项目文档列出，未经本站实测。

详细介绍

RPG Maker MV Ultimate MCP 服务器让 AI 助手能直接编辑磁盘上的真实 RPG Maker MV 项目——数据库、地图、事件、系统——通过 13 个整合工具，并依据真实引擎验证输出一致性。其亮点是基于知识的地图生成：从 106 个内置 RTP 模板中克隆手工制作的地图，并适配你的项目 tileset；对于无模板的主题则回退到程序化生成。此外，它还提供只读的项目智能（验证引用、解释事件为何不触发、审查地图）以及可选的视觉 AI 分析。