redseb/rpgmaker-mz-mcp

128个工具让AI助手直接阅读和写入RPG Maker MZ项目——演员、职业、技能、物品、装备、状态、敌人、部队、常见事件、地图、瓦片、图块集、事件和系统设置——而无需在编辑器中手动编辑所有内容。

“在世界地图下方添加一个城镇，用草地涂色，然后放进一个卖药水的店主” →完成，项目内，没有编辑点击。

快速开始

Claude Code（推荐） — 将服务器和创作技能安装为一个插件：

系统会提示你进入RPG Maker MZ项目目录（可选——你也可以稍后让Claude输入set_project。

任何其他MCP客户端——服务器在npm上;无需克隆或构建：

Claude Desktop——要么使用上面的 JSON 配置，要么从 Releases 下载一键 rpgmaker-mz-mcp.mcpb 捆绑包，用 Claude Desktop 打开。

新来的？请阅读 SETUP.md 完整攻略，EXAMPLES.md 端到端食谱。

目录

• 快速入门
• 能力
• 它们如何组合起来
• 安装
• 配置
• 使用情况
• 可用的工具
• 输入验证
• 事件验证（默认抛出）
• 参考线条
• 预演预览

Quick start

Claude Code (recommended) — installs the server and the authoring skills as one plugin:

claude plugin marketplace add Redseb/rpgmaker-mz-mcp
claude plugin install rpgmaker-mz@rpgmaker-mz-mcp

You’ll be prompted for your RPG Maker MZ project directory (optional — you can also just ask Claude to set_project later).

Any other MCP client — the server is on npm; no clone or build needed:

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

Claude Desktop — either the JSON config above, or download the one-click rpgmaker-mz-mcp.mcpb bundle from Releases and open it with Claude Desktop.

New here? Read SETUP.md for the full walkthrough and EXAMPLES.md for end-to-end recipes.

Contents

• Quick start
• Capabilities
• How it fits together
• Installation
• Configuration
• Usage
• Available tools
• Input validation
• Event validation (throw-by-default)
• Reference linting
• Dry-run preview
• Custom-tileset catalog skill
• Example prompts
• Development
• Project structure
• Safety and best practices
• Limitations

Capabilities