Wow API MCP

哇api mcp

](https://www.npmjs.com/package/wow-api-mcp) ](https://www.npmjs.com/package/wow-api-mcp) 

用于魔兽世界API数据的MCP服务器。解析 ketho.wow-api VS Code扩展的注释和通过可查询工具公开结构化WoW API数据，包括不推荐使用的函数、替换、参数类型、返回类型、游戏版本兼容性、枚举、事件和小部件方法。

旨在为人工智能代理（Claude Code、Claude Desktop等）提供准确、结构化的WoW API数据，而无需依赖维基模板解析。

快速开始

1.安装VS代码扩展

服务器从 ketho.wow-api VS代码扩展名。先安装：

code --install-extension ketho.wow-api

2.添加到您的MCP客户端

克劳德代码 --添加到您的项目 .mcp.json:

macOS/Linux：

{
  "mcpServers": {
    "wow-api": {
      "command": "npx",
      "args": ["wow-api-mcp"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "wow-api": {
      "command": "cmd",
      "args": ["/c", "npx", "wow-api-mcp"]
    }
  }
}

3.重新启动MCP客户端

重新启动Claude Code（或您正在使用的任何客户端），工具将可用。

特性

• 弃用的功能跟踪 -立即知道API是否被弃用，是什么替换了它，以及哪个补丁更改了它
• 全功能签名 --具有类型、可选标志、默认值和返回值的参数
• 游戏版本意识 --查看Mainline、Vanilla或Mists中是否存在函数
• 命名空间浏览 --探索所有260+个C_命名空间
• 小工具API --查找任何UI小部件类（Frame、Button等）的方法
• 枚举分辨率 --获取任何WoW枚举的实际值
• 事件有效载荷 --查看每个帧事件传递哪些参数

工具

使用示例

> lookup_api("IsSpellKnown")

[DEPRECATED] IsSpellKnown
  Replaced by: C_SpellBook.IsSpellInSpellBook
  Replacement docs: https://warcraft.wiki.gg/wiki/API_C_SpellBook.IsSpellInSpellBook
  Parameters:
    spellID: number
    isPet: boolean
  Returns:
    isInSpellBook: boolean

> lookup_api("C_SpellBook.IsSpellKnown")

C_SpellBook.IsSpellKnown
  Description: Returns true if a player knows a spell...
  Wiki: https://warcraft.wiki.gg/wiki/API_C_SpellBook.IsSpellKnown
  Game versions: Mainline, Vanilla, Mists
  Parameters:
    spellID: number
    spellBank?: Enum.SpellBookSpellBank -- Default = Player
  Returns:
    isKnown: boolean

> list_deprecated("Spell")

9 deprecated function(s) matching "Spell":
IsSpellOverlayed -> C_SpellActivationOverlay.IsSpellOverlayed [patch 11.2.0]
IsPlayerSpell -> C_SpellBook.IsSpellKnown
IsSpellKnown -> C_SpellBook.IsSpellInSpellBook
...

> get_enum("SpellBookSpellBank")

Enum.SpellBookSpellBank:
  Player = 0
  Pet = 1

数据

从扩展的LuaLS注释中对整个WoW API进行索引：

• 8000多种功能 具有完整签名、参数、返回类型和wiki链接
• 90+已弃用的功能 具有替换功能、替换URL和弃用补丁版本
• 260 C_命名空间 （C_SpellBook、C_Item、C_Spell等）
• 860+小部件类型 使用方法（Frame、Button、ScriptRegion等）
• 843个枚举 带值（Enum.SpellBookSpellBank等）
• 1716事件 带有有效载荷参数（ADDON_LOADED、PLAYER_LOGIN等）
• 1591辆CVars
• 游戏版本兼容性 按功能（主线、香草、薄雾）

其他MCP客户端

克劳德桌面版

添加到您的配置文件中：

• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

macOS/Linux：

{
  "mcpServers": {
    "wow-api": {
      "command": "npx",
      "args": ["wow-api-mcp"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "wow-api": {
      "command": "cmd",
      "args": ["/c", "npx", "wow-api-mcp"]
    }
  }
}

VS代码（复制品/其他MCP客户端）

添加到您的工作区 .vscode/mcp.json:

macOS/Linux：

{
  "servers": {
    "wow-api": {
      "command": "npx",
      "args": ["wow-api-mcp"]
    }
  }
}

窗户：

{
  "servers": {
    "wow-api": {
      "command": "cmd",
      "args": ["/c", "npx", "wow-api-mcp"]
    }
  }
}

配置

扩展发现

服务器自动发现 ketho.wow-api 从这些位置扩展：

• ~/.vscode/extensions/ （VS代码）
• ~/.vscode-insiders/extensions/ （VS代码内部人员）
• ~/.vscode-oss/extensions/ （VS代码OSS/VSCodium）
• ~/.cursor/extensions/ （光标）

如果您的扩展安装在其他地方，请设置 WOW_API_EXT_PATH 环境变量：

{
  "mcpServers": {
    "wow-api": {
      "command": "cmd",
      "args": ["/c", "npx", "wow-api-mcp"],
      "env": {
        "WOW_API_EXT_PATH": "/path/to/ketho.wow-api-0.22.1"
      }
    }
  }
}

自动允许工具（克劳德代码）

要跳过权限提示，请添加到 .claude/settings.local.json:

{
  "permissions": {
    "allow": ["mcp__wow-api__*"]
  }
}

更新中

服务器在启动时读取已安装的VS Code扩展。当扩展更新时（通常是使用主要的魔兽世界补丁）：

1. 更新VS代码中的扩展名
2. 重新启动MCP客户端

服务器自动获取最新数据。

发展

要从源代码运行，请执行以下操作：

git clone https://github.com/Wutname1/wow-api-mcp.git
cd wow-api-mcp
npm install
node src/index.mjs

许可证

麻省理工学院