适合谁
- 使用 RPG Maker MV 的游戏开发者
- 希望用 AI 加速关卡设计的场景
- 需要通过 MCP 与项目交互的 AI 代理
R
58FMRS · C
该服务器扩展了 MCP 生态至 RPG Maker MV，提供独特的基于模板的地图生成和项目智慧分析。13 个工具覆盖 CRUD、地图编辑、事件管理和系统操作。亮点是知识驱动的地图生成（克隆模板）、只读项目分析（验证、解释、审查、重构）和可选视觉 AI。安装通过 npx，简单。有风险但提供备份和 dryRun。适合游戏开发者，但需注意备份和视觉 AI 端点配置。
RPG Maker MV Ultimate MCP 服务器让 AI 助手能直接编辑磁盘上的真实 RPG Maker MV 项目——数据库、地图、事件、系统——通过 13 个整合工具，并依据真实引擎验证输出一致性。其亮点是基于知识的地图生成：从 106 个内置 RTP 模板中克隆手工制作的地图，并适配你的项目 tileset；对于无模板的主题则回退到程序化生成。此外，它还提供只读的项目智能（验证引用、解释事件为何不触发、审查地图）以及可选的视觉 AI 分析。
工具能力
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、拼图开关）、更新、转换现有事件为商人/旅店/标牌、删除、添加指令、批量填充。
manage_system
管理游戏标题、开关/变量名称、起始位置；编写插件、搭建新项目、运行游戏或打开编辑器。
analyze_project
只读项目智慧：概览、索引、验证、图表、用法、解释、AST、插件、审查、重构、搜索。
get_project_context
项目摘要、资源索引、各图块组 tile ID、内置模板目录。
set_project_path
运行时切换项目。
analyze_image
可选的视觉 AI 图像分析，及离线图块网格测量和象限颜色。
安装接入
通过 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"
}
}
}
}
选型与风险
不适合谁
- 非 RPG Maker MV 项目
- 需要可视化编辑器的实时同步（此工具直接改文件，非 GUI）
- 期望无需额外配置就能使用视觉 AI 能力的用户
所需权限
- 读写项目文件（data/ 和 js/）
- 运行项目（playtest）或打开编辑器
- 网络访问（可选，仅用于视觉 AI）
风险与副作用
- 误操作可能破坏项目数据，但有备份机制
- 使用视觉 AI 时会将图像发送到配置的端点
- 程序化生成可能不符合设计意图
常见排障
- 确保 RPGMAKER_PROJECT_PATH 正确指向项目文件夹（含 data 和 js）
- 若视觉功能不工作，检查 VISION_API_URL、VISION_API_KEY、VISION_MODEL 设置
- 写入操作失败时检查备份目录 .mcp-backups/
- 运行 playtest 需找到引擎安装位置（通过 install 或默认 Steam 路径）
使用场景
从文本描述生成完整、可玩的地图（城镇、地牢等）。
通过自然语言创建 NPC、商店、传送点、Boss 事件。
分析项目一致性，查找断链引用、不可达地图。
解释为什么某个事件（如门）从不触发。
设计审查地图：死区、拥挤、事件分布。
快速搭建新项目或编写插件。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
opencode完整支持