Warcraft 3 MCP Server

Claudeに話しかけるだけでWarcraft IIIのマップを編集できます。

これは、ClaudeをあなたのWarcraft III .w3x / .w3m マップファイルに接続するMCPサーバーです。セットアップが完了すると、次のようなことを言えます:

「マップの中央にプレイヤー1のフットマンを追加して。」 「すべてのグラントのヒットポイントを2倍にして。」 「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) — 次の1つのコマンドを実行します(ビルドしたフォルダのフルパスを使用):

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

Claude Desktop (アプリ) — Settings → Developer → Edit Config を開き、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に普通の英語で質問し、マップのフルパスを渡すだけです。例:

「C:\Users\Me\Desktop\MyMap.w3x の概要を wc3 で教えて。」

デフォルトでは、編集内容はマップの隣にコピー (MyMap.edited.w3x) として保存されるため、元のファイルは安全です。その場で編集したい場合は、Claudeに 「元のファイルを上書きして」 と伝えてください。

Claudeにできること(ツール)

マップを確認する

マップを変更する

新しいものを作成する

変更を確認する

GUIトリガー (1.1の新機能)

Claudeは実際のGUIトリガーツリーを読み取り・編集できます。これはトリガーエディタ (F4) で表示されるトリガーと同じものです。

「そのトリガーのアビリティをWar DrumsからBashに変更して。」 「フットマンが最初の攻撃でグラントを倒すGUIトリガーを作成して。」

トリガーをリクエストすると…

…すると、トリガーエディタに実際のトリガーが表示されます:

知っておくべきこと:

• 変更はエディタ独自のトリガーデータ (war3map.wtg) に書き込まれるため、トリガーエディタに表示され、保存後も維持されます。

• 設計上の安全性: 書き込み前に、サーバーはマップのトリガーをバイト単位で再構築できることを検証します。できない場合は、トリガーに一切触れません。

• GUI変更後は、マップを開いて一度保存してください。そのときにエディタがトリガーをプレイ可能なスクリプトにコンパイルします。その後、プレイテストを行います。

• すべての編集と同様に、先にエディタでマップを閉じ、後で再度開いてください。

参考情報

• 元のファイルは安全です — 上書きを指示しない限り、編集内容は .edited コピーに保存されます。

• トリガー/新しいロジック: wc3_set_durable_script は、JASS/Luaを war3map.wct (エディタ独自のトリガーストレージ) に保存し、さらにマップスクリプトにもミラーリングします。そのため、即座に実行され、かつエディタでの再保存後も維持され、後で編集できる形でトリガーエディタに表示されます。自動実行トリガーの場合は、先にエディタでカスタムテキストトリガーを1つ作成し (例: MCPDurable という名前)、一度保存してください。ヘッダースロット (slot:"header") はセットアップ不要です。

• 非常に大きなマップや保護されたマップでは、読み取れない部分がいくつかある場合があります。Claudeはどの部分かを教え、残りの作業を続行します。

• これは Blizzard Entertainmentとは提携関係にありません。Warcraft IIIはBlizzardの商標です。このツールは自分のマップファイルを読み書きするだけです。

ライセンス

MIT — 無料のオープンソースです。自由にご利用いただけます。