wow-dev-mcp

WoW UI Development MCP Server

A Model Context Protocol (MCP) server for World of Warcraft development tools.

Quick Install

Claude Code (run command)

claude mcp add-json wow-dev-mcp '{
  "command": "npx",
  "args": [
    "-y",
    "wow-dev-mcp@latest"
  ],
  "env": {}
}' -s user

General Installation

Available on npm registry and dockerhub via

Note: Use these command and args following your specific mcp client's (vscode/cursor/etc) configuration

npx -y wow-dev-mcp

docker run --rm -i juemrami/wow-dev-mcp

Available Tools

Global Strings Toolkit

• Search Global Strings search_wow_global_strings – Fuzzy search global string contents matching the provided query.
• List Global String Keys list_wow_global_string_keys – List all global string keys for a game client version.
• Get String Translations get_wow_global_string_translations – Retrieve translations for the specified globalKeys.

Support following WoW game client locales (will vary by client version):

• enUS - English (US)
• frFR - French
• deDE - German
• esMX - Spanish (Mexico)
• itIT - Italian
• koKR - Korean
• ptBR - Portuguese (Brazil)
• ruRU - Russian
• zhCN - Chinese (Simplified)
• zhTW - Chinese (Traditional)

Global API Toolkit

• Search Global API Names search_wow_global_api_names – Fuzzy search global API names matching the provided query.
• List Global API Names list_wow_global_api_names – List all valid global API names for a client version.

Warcraft Wiki Related Tools

• Get Global API Wiki Info get_warcraft_wiki_global_api_info – Fetch wiki page content and links (related page slugs) for the given apiName.
• Get Warcraft Wiki Page Data get_warcraft_wiki_page_data – Fetch wiki page content and links for the given page slug.

Both toolkits support multiple WoW game client flavors:

• mainline - Current retail version
• mists - Mists of Pandaria Classic
• vanilla - Classic Era WoW (incl. Hardcore/SoD)

Note: You may need to specify to the agent to use a specific game flavor todo: add tool/prompt for scanning .toc file to determine best client flavor(s)

Known Issues

• you may have to try really hard to get your llm to use optional tool parameters correctly. Depends on model.

Development

Requirements

pnpm@10.14.0

Install from Source

Setup example Vscode

To use this mcp server in dev with, for example VS Code and GitHub Copilot:

• Open VS Code
• Open the User or Workspace mcp.json config file

• Using the command palette, search for and select:
  • "MCP: Open User Configuration"
  • or "MCP: Open Workspace Configuration"

• Modify the servers section by adding the the project as a stdio mcp server:

{
"servers" : {
    // ... other mcp servers
    "wow-dev-mcp": {
        "type": "stdio",
        "command": "pnpm",
        // replace 'path/to/project' with your actual project path
        "args": [
            "tsx",
            "--watch",
            "path/to/project/src/main.ts"
        ]
    }
}
}

Building

pnpm build

Testing

pnpm vitest

Credits

• Global strings directory referenced from https://github.com/Ketho/BlizzardInterfaceResources