wow-casc-mcp-server

MCP server for reading World of Warcraft client files via CASC storage.

Tools

Setup

npm install

Community Listfile

casc_find auto-downloads the latest community listfile on first use — no manual setup needed.

Source: wowdev/wow-listfile — the canonical community listfile, same source used by wow.tools.local.

How it works:

• First casc_find without listfilePath → downloads community-listfile.csv to server directory

• Subsequent calls → uses local cache

• Cache older than 1 day → auto re-downloads

• Failed download → falls back to stale cache (if exists), otherwise returns numeric FileDataIds

Manual override: Pass listfilePath in casc_find to use a custom listfile instead.

Format: CSV with FileDataID;filename lines:

1;interface/cinematics/logo_800.avi
53183;sound/music/citymusic/darnassus/darnassus intro.mp3

MCP Config

{
  "mcpServers": {
    "wow-casc": {
      "type": "stdio",
      "command": "node",
      "args": ["path/to/mcp-casc/index.js"]
    }
  }
}

Requirements

• Node.js 18+

• World of Warcraft installation (retail)

• @jamiephan/casclib and @modelcontextprotocol/sdk (installed via npm)

Version

1.2.0 — Auto-download listfile, response limits, pagination, TTL, annotations.