# Warcraft III Map Tools

> Warcraft III Map Tools is an MCP server for games and play. Read, audit and edit Warcraft III maps byte-faithfully from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** Windows, CLI
- **Repository:** https://github.com/godmephisto/wc3-mcp
- **MCP Registry name:** io.github.GodMephisto/wc3-mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Warcraft III maps are archives of object data, scripts, imports and models. This server edits them in a byte-faithful way, meaning files the assistant does not touch keep their exact bytes. It is the MCP front end of wc3ctl, which also offers a command line tool and a desktop editor.

The README says it exposes 251 tools. The visible part of the table is the asset group: audits for suspicious imports, duplicate files by SHA-256, size reports and unused imports, model linting, texture conversion, thumbnail rendering, and replacing an asset path across object data, scripts and the import table. Others include docs_search over bundled Warcraft III references, with an optional local semantic index, and graph tools for neighbours, hubs and paths.

It needs 64-bit Windows because the game data reader is a Windows library, and Reforged is needed only for tools that read base game data. A PowerShell one-liner installs it and sets up supported apps including Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex and Zed; a Claude Desktop extension is also offered.

## Features

- **Byte-faithful editing:** Untouched files in a map keep their exact bytes.
- **Asset audits:** Finds duplicates, unused imports, oversized or odd textures and model problems.
- **Asset replacement:** Replaces an asset path across object data, scripts and the import table.
- **Bundled references:** Answers docs_search from Warcraft III references, with an optional local index.
- **One-line setup:** Installs and configures supported AI apps from PowerShell.
- **251 tools:** The README counts 251 tools across map and game data.

## Good for

- Audit a map's imports for waste before release
- Swap a model or icon path everywhere it is used
- Convert a folder of textures to one format
- Look up Warcraft III editor documentation from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add wc3-mcp -- npx -y wc3-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wc3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wc3-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wc3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wc3-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wc3-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wc3-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wc3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wc3-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wc3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wc3-mcp"
      ]
    }
  }
}
```

## Tools

- `asset_audit`: Flags suspicious imported assets.
- `asset_convert_batch`: Converts textures in a folder to one target format.
- `asset_duplicates`: Groups imported files with identical bytes and reports wasted space.
- `asset_import_wire`: Adds disk files as imports and points matching model or icon fields at them.
- `asset_list`: Lists asset paths an icon or model field can be set to.
- `asset_model_lint`: Reports structural problems in imported models.
- `asset_replace`: Replaces an asset path everywhere it is referenced.
- `asset_size_report`: Breaks imported bytes down by folder.
- `asset_thumbnails`: Renders thumbnail PNGs for models.
- `docs_search`: Searches bundled Warcraft III references.
- `rag_install`: Installs the local semantic index.
- `graph_neighbors`: Graph tool for neighbours.
- `graph_hubs`: Graph tool for hubs.
- `graph_path`: Graph tool for paths.

## FAQ

### What platform does it need?

64-bit Windows.

### Do I need the game?

Warcraft III Reforged is needed only for tools that read base game data.

### Which AI apps can it configure?

Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI, Cline, LM Studio and Zed.

### How big is the optional search index?

About 130 MB for the embedding model plus about 61 MB of corpus, downloaded once and verified.

### How do I add Warcraft III Map Tools to Claude Code?

Run this command in your terminal: claude mcp add wc3-mcp -- npx -y wc3-mcp

### What are the best alternatives to Warcraft III Map Tools?

The closest alternatives to Warcraft III Map Tools are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/warcraft-iii-map-tools
