Warcraft 3 MCP Server

只靠和 Claude 说话就能编辑你的 Warcraft III 地图。

这是一个 MCP 服务器，将 Claude 连接到你的 Warcraft III .w3x / .w3m 地图文件。设置完成后，你可以这样说：

"为玩家 1 在地图中央添加一个步兵。" "让每个兽人步兵的生命值翻倍。" "添加一个触发器，每 30 秒生成 5 只狼，然后在地图编辑器中打开地图。" "创建一个 GUI 触发器，让步兵在首次攻击时杀死兽人步兵。"

…而 Claude 会直接在你的地图文件中做出修改。

一句话原理： Warcraft 的 World Editor 没有插件/自动化系统，所以 这个服务器直接编辑地图文件。你的修改真的就在地图里——在 World Editor 中打开或游玩它，修改就在那里。

安装（5 分钟）

步骤 1 — 安装 Node.js

从 nodejs.org 下载并安装 Node.js 18 或更高版本。 （如果你想检查是否已安装，请打开终端并运行 node --version。）

步骤 2 — 下载此项目并构建

打开终端（命令提示符、PowerShell 或 Terminal）并运行：

git clone https://github.com/YElwiddi/warcraft-3-mcp-server.git
cd warcraft-3-mcp-server
npm install
npm run build

就这样——服务器现在已构建到 dist 文件夹中。

步骤 3 — 将其连接到 Claude

选择你使用的任意一种：

Claude Code（CLI） — 运行这一条命令（使用你刚刚构建的文件夹的完整路径）：

claude mcp add wc3 --scope user -- node "/full/path/to/warcraft-3-mcp-server/dist/index.js"

Claude Desktop（应用） — 打开 设置 → 开发者 → 编辑配置，然后在 mcpServers 下添加一个 wc3 条目（保留你已经有的任何服务器）：

{
  "mcpServers": {
    "wc3": {
      "command": "node",
      "args": ["C:/full/path/to/warcraft-3-mcp-server/dist/index.js"]
    }
  }
}

步骤 4 — 重启 Claude

关闭并重新打开 Claude Code / Claude Desktop，以便它加载新的工具。大功告成！

💡 提示： 即使在 Windows 上，也要在路径中使用正斜杠 /，例如 C:/Users/You/warcraft-3-mcp-server/dist/index.js。

Related MCP server: blender-mcp

试一试

直接用简单的英语问 Claude，并把地图的完整路径告诉它。例如：

"使用 wc3 给我一个 C:\Users\Me\Desktop\MyMap.w3x 的概览。"

默认情况下，修改会保存到你地图旁边的一个副本（MyMap.edited.w3x），因此你的原文件是安全的。如果你想让 Claude 直接修改原文件，就告诉它*"覆盖原文件"*。

Claude 可以做什么（工具）

查看地图

修改地图

创建新东西

查看你的修改

GUI 触发器（1.1 新增）

Claude 可以读取和编辑真正的 GUI 触发器树——也就是你在 Trigger Editor（F4）中看到的那些触发器。

"把那个触发器的技能从战鼓改成重击。" "创建一个 GUI 触发器，让步兵在首次攻击时杀死兽人步兵。"

向 Claude 请求添加一个触发器…

…然后它就是一个真正的触发器，就出现在 Trigger Editor 中：

须知：

• 修改会写入编辑器自身的触发器数据（war3map.wtg），因此它们会出现在 Trigger Editor 中，并在你保存后仍然保留。

• 设计上安全： 在进行任何写入之前，服务器会证明自己能够逐字节重建你地图的触发器。如果不能，它就会拒绝修改它们。

• 在 GUI 修改之后，打开地图并保存一次——编辑器就在此时将触发器编译为可玩的脚本。然后进行试玩测试。

• 与所有修改一样：先在编辑器中关闭地图，之后重新打开。

补充信息

• 你的原文件是安全的 — 修改会保存到 .edited 副本中，除非你要求覆盖。

• 触发器 / 新逻辑： wc3_set_durable_script 会将你的 JASS/Lua 存储在 war3map.wct（编辑器自身的触发器存储）中，并将其镜像到地图脚本里——因此它会立即运行，并且在编辑器重新保存后仍然保留，会出现在 Trigger Editor 中，你之后可以在那里编辑它。对于自动运行的触发器，请先在编辑器中创建一个自定义文本触发器（例如命名为 MCPDurable）并保存一次；头部槽位（slot:"header"）无需任何设置。

• 非常大的地图或受保护的地图可能有一些部分无法读取；Claude 会告诉你哪一部分，并继续处理其余部分。

• 本工具与 Blizzard Entertainment 没有任何关联。Warcraft III 是 Blizzard 的商标。这个工具只读取/写入你自己的地图文件。

许可证

MIT — 免费且开源。你可以随意使用它。