Azeroth MCP

AzerothCore MCP服务器

A. 模型上下文协议（MCP） 服务器，为克劳德等人工智能助手提供对AzerothCore数据库和维基文档的只读访问。这使得AI能够帮助理解生物脚本、SmartAI逻辑、数据库模式和游戏机制。

主要特点

渐进式披露和代币优化

此MCP实现 渐进式披露 减少令牌使用的模式：

• 默认情况下压缩数据：数据库查询只返回基本字段（减少75-90%）
• 延迟加载参考数据：仅在需要时加载SmartAI/条件类型定义
• 可选工具已禁用：默认情况下禁用Wiki和源代码搜索（可以通过配置启用）
• 发现层：AI可以按需探索工具类别，而不是预先加载所有文档

结果：与传统MCP服务器相比，令牌使用量减少了96-98%，同时保持了完整的功能。

特性

数据库工具

• 查询数据库 -对世界、字符或身份验证数据库执行只读SQL查询
• get_table_schema -检索表结构/列定义
• list_tables -列出具有可选模式筛选的表

生物/NPC工具

• get_creature_template -获取生物数据（默认压缩，使用 full=True 所有61个字段）
• 搜索_治疗 -按名称模式搜索生物
• get_creature_with_scripts -获取带有相关SmartAI脚本的生物模板（压缩）

SmartAI工具

• get_smart_scripts -检索SmartAI脚本（默认压缩，使用 full=True 所有33个字段）
• explain_smart_script -获取事件/动作/目标类型的文档
• 跟踪脚本链 -调试和可视化SmartAI执行流、以下链接、定时操作列表和数据触发器
• get_smartai_source -从SmartScript.cpp获取任何事件/动作/目标类型的实际C++实现
• generate_sai_注释 -为现有的生物/游戏对象脚本生成人类可读的注释
• generatecomment_for_script -在插入之前为单个新脚本行生成注释
• generatecomments_for_scripts_batch -一次为多个脚本行生成注释

拼写查找工具

• get_spell_name -从Keira3的离线数据库中按ID查找拼写名称
• lookup_spell_name -一次批量查找多个拼写名称

源代码工具（可选-默认禁用）

• search_azerothcore_source -在AzerothCore源代码中搜索模式
• read_source_file -从AzerothCore读取特定源文件
• 启用 ENABLE_SOURCE_CODE=true 在.env中

Wiki/文档工具（可选-默认禁用）

• search_wiki -搜索AzerothCore维基文档
• read_wiki_page -阅读特定的wiki页面
• 启用 ENABLE_WIKI=true 在.env中

其他实体工具

• get_gameobject_template / search_gameobjects -游戏对象查找（默认压缩，36→ ~8 字段）
• search_spells -按名称或ID搜索spell_dbc（默认情况下禁用，仅适用于自定义拼写）
• get_quest_template / 搜索任务 -任务查找（默认压缩，105→ ~15 字段）
• 诊断查询 -全面的任务诊断（给出者、结束者、需求、链、条件、面包屑检测、带有修复提示的问题）
• get_item_template / 搜索项目 -项目查找（默认压缩，139→ ~12 字段）

条件工具

• get_conditions -获取特定来源的条件（战利品、八卦、任务、智能AI、供应商等）
• 解释条件 -获取条件源类型和条件类型的文档
• 诊断条件 -检查是否存在损坏的引用和常见问题
• 搜索条件 -按类型或值搜索条件

航点工具

• get_waypoint_path -获取航路点路径数据（默认压缩，11→ ~4 字段）
• get_creasure_waypoints -获取生物输入的所有航路点路径（压缩）
• 搜索路径 -在数据库中查找航路点路径
• 可视化路径点 -生成地形上航路点的二维PNG可视化
• 可视化工作点3d -使用地形生成交互式3D可视化（在浏览器中打开）

- 点击航路点进行选择，按住shift键并点击地形进行移动 - 累积更改并一次导出所有SQL语句 - 将附近的NPC和游戏对象显示为地标

SOAP/Worldserver命令工具

• soapexecute命令 -通过SOAP在正在运行的worldserver上执行任何GM命令
• soap_server_info -获取服务器正常运行时间、玩家数量和版本信息
• soap_reload_table -无需重新启动服务器即可热重新加载数据库表
• soap_check_连接 -测试SOAP连接和身份验证

数据包解析器工具（WowPacketParser集成）

从WowPacketParser嗅探文件中进行有针对性的提取。专为大型解析文件的上下文高效分析而设计。

导航：

• list_packet_types -用计数列出解析文件中的所有操作码
• 搜索包 -按操作码、条目ID、内容或数据包范围查找数据包
• get_packet_by_number -按编号获取特定数据包
• get_packets_around -获取数据包周围的上下文（数据包之前/之后）

结构化提取：

• 提取创造查询 -从SMSG_QUERY_creature_RESPONSE中提取生物模板数据
• 提取名称对象查询 -从SMSG_QUERY_gameobject_RESPONSE中提取游戏对象数据
• 提取查询 -从SMSG_QUERY_quest_info_RESPONSE中提取任务信息
• extract_monster_moves -从SMSG_ON_MONSTER_MOVE中提取移动/航路点数据
• extract_chat消息 -从SMSG_CHAT中提取NPC说/喊/表情
• 提取器_过滤器_夹具 -从SMSG_spell_GO中提取拼写数据
• 提取物_微粒 -从SMSG_emote中提取表情动画

高级：

• parse_pkt_targeted -在带有过滤器（操作码、条目、数据包限制）的.pkt文件上运行WowPacketParser

需求

• Python 3.10+
• MySQL与AzerothCore数据库
• （可选）本地副本 AzerothCore维基

安装

1. 克隆存储库（带有Keira3拼写数据库的子模块）：

git clone --recursive https://github.com/yourusername/azerothMCP.git
cd azerothMCP

如果你已经克隆了 --recursive，初始化子模块：

git submodule update --init --recursive

1. 创建并激活虚拟环境：

python3 -m venv venv
source venv/bin/activate

1. 安装依赖项：

pip install -r requirements.txt

1. 创建一个 .env 使用您的配置文件：

# Database connection
DB_HOST=localhost
DB_PORT=3306
DB_USER=acore
DB_PASSWORD=acore

# Database names
DB_WORLD=acore_world
DB_CHARACTERS=acore_characters
DB_AUTH=acore_auth

# Read-only mode (default: true)
# Set to "false" to allow INSERT, UPDATE, DELETE queries
READ_ONLY=true

# Enable spell_dbc tool (default: false, for custom spells only)
ENABLE_SPELL_DBC=false

# Enable wiki search tools (default: false)
# Disabled by default to reduce token usage
ENABLE_WIKI=false

# Enable source code search tools (default: false)
# Disabled by default to reduce token usage
ENABLE_SOURCE_CODE=false

# Wiki documentation path (only needed if ENABLE_WIKI=true)
# Clone https://github.com/azerothcore/wiki to ~/wiki
WIKI_PATH=~/wiki/docs

# AzerothCore source path (only needed if ENABLE_SOURCE_CODE=true)
AZEROTHCORE_SRC_PATH=~/azerothcore

# MCP server port
MCP_PORT=8080

# Maps path for terrain visualization (optional)
# Point to your AzerothCore server's maps directory
MAPS_PATH=~/azerothcore/data/maps

# Visualization server (for remote access to 3D waypoint visualizations)
VIZ_HOST=localhost
VIZ_PORT=8888

# SOAP Configuration (optional - for live server commands)
# Requires SOAP.Enabled = 1 in worldserver.conf
SOAP_ENABLED=false
SOAP_HOST=127.0.0.1
SOAP_PORT=7878
SOAP_USERNAME=your_admin_account
SOAP_PASSWORD=your_account_password

# WowPacketParser Configuration (optional - for sniff analysis)
ENABLE_PACKET_PARSER=true
WPP_PATH=~/WowPacketParser/WowPacketParser/bin/Release
DOTNET_PATH=~/.dotnet/dotnet

项目结构

azerothMCP/
├── main.py                      # Entry point
├── azerothmcp/                  # Main package
│   ├── __init__.py
│   ├── config.py                # Configuration (DB, paths, flags)
│   ├── db.py                    # Database connection & query execution
│   ├── map_parser.py            # AzerothCore .map file parser for terrain
│   └── tools/                   # MCP tool modules
│       ├── __init__.py          # Tool registration
│       ├── database.py          # Database query tools
│       ├── creatures.py         # Creature/NPC tools
│       ├── smartai.py           # SmartAI scripting tools
│       ├── source.py            # AzerothCore source code tools
│       ├── wiki.py              # Wiki documentation tools
│       ├── gameobjects.py       # GameObject tools
│       ├── quests.py            # Quest tools
│       ├── items.py             # Item tools
│       ├── spells.py            # Spell lookup tools
│       ├── soap.py              # SOAP worldserver command tools
│       ├── conditions.py        # Conditions table tools
│       ├── waypoints.py         # Waypoint visualization tools
│       └── packets.py           # WowPacketParser sniff analysis tools
├── sai_comment_generator.py     # Keira3 SAI comment generator
├── soap_client.py               # SOAP client for worldserver
└── keira3/                      # Keira3 submodule (spell database)

用法

运行服务器

启动MCP服务器：

source venv/bin/activate
python main.py

服务器启动于 http://localhost:8080/sse 使用服务器发送事件（SSE）传输。

与Claude Desktop连接

添加到您的Claude Desktop MCP配置中：

Linux： ~/.config/Claude/claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azerothcore": {
      "url": "http://localhost:8080/sse"
    }
  }
}

然后重新启动Claude Desktop。AzerothCore工具将在您的对话中可用。

与克劳德代码连接

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "azerothcore": {
      "url": "http://localhost:8080/sse"
    }
  }
}

示例提示

连接后，您可以问以下问题：

• “霍格（条目448）有什么脚本？”
• “显示creature_template架构”
• “搜索名为‘Defias’的生物”
• “解释SmartAI事件类型4”
• “追踪生物1234的脚本链”
• “查找与Westfall相关的任务”
• “为此SmartAI脚本生成评论”
• “ID 17364是什么咒语？”

Wiki设置（可选）

要启用wiki搜索功能，请克隆AzerothCore wiki：

cd ~
git clone https://github.com/azerothcore/wiki.git

服务器将在以下位置搜索markdown文件 ~/wiki/docs 默认情况下。更新 WIKI_PATH 在你的 .env 如果你的wiki位于其他位置。

SOAP设置（可选）

SOAP允许在正在运行的worldserver上执行GM命令。这使得实时服务器管理成为可能，例如在数据库更改后重新加载表、检查服务器状态或管理帐户。

1.在worldserver.conf中启用SOAP

SOAP.Enabled = 1
SOAP.IP = "127.0.0.1"
SOAP.Port = 7878

2.配置环境变量

该帐户必须具有管理员权限（SEC_administrator，gmlevel 3+）：

SOAP_ENABLED=true
SOAP_HOST=127.0.0.1
SOAP_PORT=7878
SOAP_USERNAME=your_admin_account
SOAP_PASSWORD=your_account_password

SOAP命令示例

配置后，您可以使用以下提示：

• “检查worldserver是否正在运行”
• “重新加载creature_template表”
• “获取服务器信息”
• “执行命令：查找生物霍格尔”

安全

默认情况下，服务器在 只读模式.只有 SELECT, SHOW，以及 DESCRIBE 允许查询。

要启用写入操作（INSERT、UPDATE、DELETE）以实现完全自动化：

READ_ONLY=false

警告： 启用写入模式允许AI修改您的数据库。请谨慎使用，并确保您有备份。

许可证

GNU GPL v2-请参阅 许可证

相关项目

• 阿塞拜疆核心 -开源WoW模拟器
• 凯拉3 -AzerothCore数据库编辑器（用于生成评论的拼写数据库）
• 模型上下文协议 -AI上下文共享的开放协议