wow-casc-mcp-server

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

Tools

Tool	Description
casc_open	Open CASC storage, returns handleId
casc_find	Find files by wildcard mask
casc_read	Read file content (text or base64)
casc_close	Close storage handle

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.