AI导哈

RPG Maker MZ MCP服务器

一个强大的模型上下文协议（MCP）服务器，允许AI代理（如Claude、Gemini或Copilot）直接操作RPG Maker MZ项目文件。

  • by devmagary
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 devmagary/MCP-Maker

使用说明

RPG制造商MZ MCP服务器🎮✨

一个强大的 模型上下文协议（MCP） 允许AI代理（如Claude、Gemini或Copilot）直接操纵的服务器 RPG制造商MZ 项目。

使用此工具，您可以要求您的AI“创建一把火剑”、“制作一种可以再生法力的药水”或“生成一张新地图”，它将直接修改游戏文件！

🚀 特性

📦 数据库管理（全CRUD）

创建、读取和更新几乎任何数据库资产：

  • 项目： 创建药水、钥匙和隐藏物品。支持HP/MP恢复和状态应用程序。
  • 武器和盔甲： 使用统计数据、价格和元素效果创建装备。
  • 敌人： 定义统计数据（HP/MP/ATK…）、下降和奖励（经验/黄金）。
  • 国家： 使用特征创建状态效果（例如，毒药、再生、眩晕）。
  • 演员和课程： 创建具有水平曲线和特征的新英雄和职业。
  • 技能： 定义魔法和特殊攻击。

🗺️ 地图与世界

  • 创建地图： 生成新地图文件(MapXXX.json)带有元数据（大小、拼贴集、BGM）。
  • 列表地图： 查看项目层次结构中的所有地图。

🧩 插件和资源

  • 插件安装程序： 自动创建 .js 文件在 js/plugins 并将其注册在 plugins.js.
  • 资源扫描程序： 列出可用图形(img/)，音频(audio/)，以及DLC包。

🛡️ 安全第一

  • Atomic写道： 使用a SafeWriter 以防止数据损坏。
  • 编辑器同步： 自动更新 System.json 版本ID，强制RPG Maker MZ编辑器重新加载数据并防止冲突。

🛠️ 安装

  1. 克隆存储库：

    git clone https://github.com/devmagary/MCP-Maker.git
cd MCP-Maker

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

⚙️ 配置

你需要告诉MCP客户端你的RPG Maker MZ项目和引擎的位置。

环境变量

  • RPGMAKER_PROJECT_PATH：游戏项目的完整路径（其中 game.rmmzproject 是）。
  • RPGMAKER_ENGINE_PATH：RPG Maker MZ安装的完整路径（通常是Steam文件夹）。

配置示例

VS代码（克劳德·德夫/副驾驶）

添加到您的设置或MCP配置中：

{
  "mcpServers": {
    "rpgmaker-mz": {
      "command": "node",
      "args": ["C:/path/to/MCP-Maker/dist/index.js"],
      "env": {
        "RPGMAKER_PROJECT_PATH": "C:/Users/You/Documents/RMMZ/MyGame",
        "RPGMAKER_ENGINE_PATH": "C:/Program Files (x86)/Steam/steamapps/common/RPG Maker MZ"
      }
    }
  }
}

克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "rpgmaker-mz": {
      "command": "node",
      "args": ["C:\\path\\to\\MCP-Maker\\dist\\index.js"],
      "env": {
        "RPGMAKER_PROJECT_PATH": "C:\\Users\\You\\Documents\\RMMZ\\MyGame",
        "RPGMAKER_ENGINE_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\RPG Maker MZ"
      }
    }
  }
}

💻 技术栈

  • TypeScript：严格键入以确保稳健性。
  • 萨德：所有工具输入的运行时模式验证。
  • MCP-SDK：官方模型上下文协议SDK。
  • Node.js：运行时环境。

🤝 贡献

如果您想添加更多功能（例如，事件创建支持），请随时打开问题或提交PR！

创建于❤️ 通过 DevMagary & 反重力.

相关 MCP