Warcraft 3 MCP 서버

Claude와 대화만으로 Warcraft III 맵을 편집하세요.

이것은 Claude를 Warcraft III .w3x / .w3m 맵 파일에 연결하는 MCP 서버입니다. 설정이 완료되면 다음과 같이 말할 수 있습니다:

"플레이어 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 트리거 트리를 읽고 편집할 수 있습니다 — 트리거 편집기(F4)에서 볼 수 있는 것과 동일한 트리거입니다.

"그 트리거의 능력을 War Drums에서 Bash로 변경해." "풋맨이 첫 공격에 그런트를 죽이는 GUI 트리거를 만들어."

트리거를 요청하면…

…트리거 편집기에 실제 트리거로 나타납니다:

알아야 할 사항:

• 변경 사항은 편집기 자체의 트리거 데이터(war3map.wtg)에 기록되므로 트리거 편집기에 표시되고 저장 후에도 유지됩니다.

• 설계상 안전: 쓰기 전에 서버는 맵의 트리거를 바이트 단위로 재구성할 수 있음을 증명합니다. 그렇지 않으면 트리거를 건드리지 않습니다.

• GUI 변경 후 맵을 열고 한 번 저장하세요 — 그때 편집기가 트리거를 실행 가능한 스크립트로 컴파일합니다. 그런 다음 플레이 테스트하세요.

• 모든 편집과 마찬가지로: 먼저 편집기에서 맵을 닫고, 다시 연 후 사용하세요.

참고 사항

• 원본은 안전합니다 — 덮어쓰기를 요청하지 않는 한 편집 내용은 .edited 복사본으로 저장됩니다.

• 트리거 / 새 로직: wc3_set_durable_script는 JASS/Lua를 war3map.wct(편집기 자체 트리거 저장소)에 저장하고 맵 스크립트에도 미러링합니다 — 따라서 즉시 실행되고 편집기 재저장에도 유지되며, 나중에 편집할 수 있도록 트리거 편집기에 나타납니다. 자동 실행 트리거의 경우 편집기에서 먼저 사용자 정의 텍스트 트리거를 하나 생성하고(예: MCPDurable) 한 번 저장하세요. 헤더 슬롯(slot:"header")은 설정이 필요 없습니다.

• 매우 크거나 보호된 맵은 읽을 수 없는 일부 부분이 있을 수 있습니다. Claude가 해당 부분을 알려주고 나머지 작업은 계속 진행합니다.

• 이 도구는 Blizzard Entertainment와 관련이 없습니다. Warcraft III는 Blizzard의 상표입니다. 이 도구는 사용자 자신의 맵 파일만 읽고 씁니다.

라이선스

MIT — 무료이며 오픈 소스입니다. 원하는 대로 사용하세요.