TrinityCore MCP服务器
企业级模型上下文协议服务器 提供 107个MCP工具 用于《魔兽世界》12.0（午夜版）的TrinityCore机器人开发。包括全面的游戏数据访问、人工智能驱动的代码分析、性能分析和功能齐全的web界面。
______________________________________________________________________
🚀 快速开始
# Clone repository
git clone https://github.com/agatho/trinitycore-mcp.git
cd trinitycore-mcp
# Install dependencies
npm install
# Build TypeScript
npm run build
# Start both MCP server and Web UI
npm run start:allWeb UI将在以下位置打开： http://localhost:3000
______________________________________________________________________
📋 目录
______________________________________________________________________
概述
这 TrinityCore MCP服务器 是一个用于构建和管理TrinityCore PlayerBots的综合开发平台。它提供：
- 107 MCP工具 -用于游戏数据、代码分析、测试和自动化的完整API
- 全功能Web UI -交互式Next.js 16界面，36页以上
- AI驱动的代码审查 -1020+C++分析的TrinityCore特定规则
- DBC/DB2支持 -解析WDC5/WDC6客户端数据库文件
- 性能分析 -机器人缩放模拟（100-5000个机器人）
- 实时数据库访问 -通过MCP进行MySQL实时查询
- 3800+API文档 -完整的TrinityCore C++API参考
- VMap/MMap集成 -高度检测和寻路支持
______________________________________________________________________
特性
核心MCP服务器（107个工具）
游戏数据和查询（40个工具）
- 法术 -法术信息、伤害/愈合计算、比较、最佳选择
- 物品 -项目数据、齿轮评分、最佳槽内查找器、设置优化
- 任务 -任务链、先决条件、奖励、路线优化
- 生物 -NPC数据、供应商、培训师、产卵地点、统计数据
- 世界数据 -兴趣点、游戏对象、衍生搜索
- DBC/DB2 -客户端数据库文件解析（WDC5/WDC6支持）
- 游戏桌 -战斗等级、XP表、角色统计、缩放数据
战斗与优化（12个工具）
- 人才 -专业化信息、推荐版本、级别比较
- 战斗力学 -近战伤害、护甲减轻、威胁、收益递减
- 爱好者 -自助餐推荐、团体覆盖率分析、消耗品优化
- 地牢战略 -老板机制、布局、团队构成、神话+策略
经济与社会（8种工具）
- 经济 -项目定价、拍卖行分析、套利、黄金制造策略
- 声誉 -派系信息、声誉研磨路径、奖励跟踪
- 职业 -配方数据、技能提升计划、盈利能力分析
小组协调和PvP（8个工具）
- 协调 -小组组成分析、冷却协调、战术任务
- 玩家对战 -竞技场构成分析、战场策略、PvP天赋构建
收藏与调平（7个工具）
- 集合 -宠物/坐骑/玩具追踪、丢失的收藏品、农耕路线
- 任务路由 -最佳任务路径、调平路线、每日电路、区域分析
知识库和代码生成（12个工具）
- 文档 -PlayerBot wiki搜索、代码模式、实现指南
- 代码生成 -Bot组件模板、数据包处理程序、CMake集成
- API 参考 -3800+TrinityCore C++方法文档
性能与测试（9个工具）
- 性能分析 -实时指标、缩放模拟、优化建议
- 测试自动化 -测试执行，多格式报告（JSON/HTML/Markdown/JUnit）
- 覆盖率分析 -具有阈值验证的代码覆盖率
数据库工具（11个工具）
- 模式探索 -表列表、模式检查、关系映射
- 数据库操作 -导出/导入、备份/恢复、健康检查
- 架构比较 -数据库差异、迁移支持
AI代码审查和分析（11个工具）
- 代码审查 -7类1020+规则（空安全、内存、并发等）
- 线程安全 -竞争条件检测、死锁分析、锁模式验证
- 内存分析 -内存泄漏检测、RAII违规、循环引用
- API迁移 -版本迁移支持（3.3.5a→ 12.0)
- 机器人AI分析 -决策树可视化，美人鱼流程图生成
- 作战日志分析 -DPS/HPS/TPS指标、轮换质量、优化建议
生产与监控（11种工具）
- 健康监测 -服务器健康状态、组件检查、系统指标
- 日志记录 -日志查询、过滤、文件位置
- 备份 -自动/手动备份、验证、完整性检查
- 安全 -安全状态、速率限制、访问控制审计
- 代码风格 -命名约定检查、格式验证、自动修复
VMap和MMap工具（8个工具）
- 虚拟内存区域 -视线测试、高度检测、产卵半径搜索
- 内存映射 -寻路、导航网格验证、路径计算
配置和测试生成（8个工具）
- 配置 -获取/更新/验证/重置/导出服务器配置
- AI测试生成 -AI驱动的测试生成、性能/负载测试
Web用户界面（Next.js 16）
附带的web界面提供 36+互动页面 全面的TrinityCore开发：
核心功能
- 首页 -美丽的深色渐变UI，带有实时MCP状态
- API资源管理器 -通过搜索浏览3800+TrinityCore方法
- 互动游乐场 -使用JSON编辑器和历史记录测试所有107个MCP工具
- 实时数据库访问 -通过MCP协议直接查询MySQL
数据浏览器
- 拼写浏览器 -使用学校/效果过滤搜索45000多种法术
- 项目数据库 -使用质量/统计过滤进行项目搜索
- 生物探索者 -使用类型/派系/供应商过滤器进行NPC搜索
- Quest查看器 -任务链、先决条件、奖励可视化
分析和工具
- 分析仪表板 -法术/物品/生物分布的交互式图表（Recharts）
- 比较工具 -并排批次比较（最多10个项目），突出显示差异
- 高级搜索 -模糊搜索（Fuse.js）、多准则过滤、保存预设
- 数据导出 -导出为CSV、Excel、JSON、PDF、XML格式
开发者工具
- AI代码审查 -上传C++文件用于TrinityCore特定分析（1020条规则）
- 机器人AI可视化工具 -使用Mermaid流程图分析PlayerBot AI
- 服务器监控 -实时健康、CPU、内存、延迟图
- 数据库架构资源管理器 -可视化ER图、查询生成器、模式比较
- 性能剖析器 -查询优化、慢速查询检测、N+1分析
工作流和数据管理
- 工作流程自动化 -自动化开发任务、代码生成、服务器管理
- 迁移管理器 -数据库版本控制、迁移跟踪
- 文档生成器 -自动生成架构文档
- 实时数据检查器 -通过TrinityCore SOAP API实时监控服务器
UI功能
- 深色模式 -为开发而优化的完整黑暗主题
- 响应式设计 -桌面、平板电脑和移动设备优化
- 全局搜索 -Cmd+K快速搜索所有数据
- 复制到剪贴板 -JSON、CSV、TSV剪贴板支持
- 打印优化 -布局简洁的PDF导出
______________________________________________________________________
安装
先决条件
- Node.js 18+ - 下载
- MySQL 9.4 （可选）-TrinityCore数据库实现完整功能
- TrinityCore构建 （可选）-用于DBC/DB2文件路径
安装步骤
# 1. Clone repository
git clone https://github.com/agatho/trinitycore-mcp.git
cd trinitycore-mcp
# 2. Install dependencies
npm install
# 3. Build TypeScript to JavaScript
npm run build
# 4. Verify build output
ls dist/
# Should see: index.js, tools/, database/, etc.Web UI安装
# Install Web UI dependencies
cd web-ui
npm install
cd ..______________________________________________________________________
配置
环境变量
创建 .env 项目根目录中的文件：
# TrinityCore Database (Required for game data queries)
TRINITY_DB_HOST=localhost
TRINITY_DB_PORT=3306
TRINITY_DB_USER=trinity
TRINITY_DB_PASSWORD=your_password
TRINITY_DB_AUTH=auth
TRINITY_DB_CHARACTERS=characters
TRINITY_DB_WORLD=world
# TrinityCore Paths (Optional - for DBC/DB2 reading)
TRINITY_ROOT=C:\TrinityBots\TrinityCore
DBC_PATH=C:\TrinityBots\Server\data\dbc
DB2_PATH=C:\TrinityBots\Server\data\db2
# VMap/MMap Paths (Optional - for height/pathfinding)
VMAP_DATA_PATH=C:\TrinityBots\Server\data\vmaps
MMAP_DATA_PATH=C:\TrinityBots\Server\data\mmaps
# MCP Server (Optional - defaults shown)
MCP_PORT=3000
MCP_HOST=localhostClaude代码集成
增添 .claude/mcp-servers-config.json 或 claude_desktop_config.json:
{
"mcpServers": {
"trinitycore": {
"command": "node",
"args": ["C:\\TrinityBots\\trinitycore-mcp\\dist\\index.js"],
"env": {
"TRINITY_DB_HOST": "localhost",
"TRINITY_DB_PORT": "3306",
"TRINITY_DB_USER": "trinity",
"TRINITY_DB_PASSWORD": "${TRINITY_DB_PASSWORD}",
"TRINITY_ROOT": "C:\\TrinityBots\\TrinityCore",
"DBC_PATH": "C:\\TrinityBots\\Server\\data\\dbc",
"DB2_PATH": "C:\\TrinityBots\\Server\\data\\db2"
}
}
}
}有关详细配置，请参阅 MCP_CONFIGURATION.md
______________________________________________________________________
用法
启动MCP服务器和Web UI（推荐）
npm run start:all这将：
- 构建MCP服务器（如果尚未构建）
- 安装Web UI依赖项（如果需要）
- 启动MCP服务器（stdio模式）
- 启动Web UI(http://localhost:3000)
- 自动打开浏览器
单独启动服务
仅限MCP服务器
# Production mode (stdio transport)
npm start
# or
npm run start:mcp
# Development mode (watch for changes)
npm run dev仅限Web UI
npm run start:web启动Next.js开发服务器http://localhost:3000
______________________________________________________________________
MCP工具（共107个）
MCP服务器提供 107个注册工具 分为以下几类：
按类别快速参考
| 类别 | 工具 | 描述 |
|---|---|---|
| 游戏数据 | 40 | 法术、物品、任务、生物、世界数据、DBC/DB2、游戏桌 |
| 战斗与优化 | 12 | 天赋、战斗力学、增益、地牢策略 |
| 经济与社会 | 8 | 商品定价、声誉、职业 |
| 集团和私人 | 8 | 协调、竞技场、战场 |
| 收藏与分级 | 7 | 收藏品、任务路线、区域分析 |
| 知识与编码 | 12 | 文档、代码生成、API参考 |
| 性能与测试 | 9 | 性能分析、测试、覆盖 |
| 数据库 | 11 | 架构、导出/导入、备份/还原 |
| AI代码审查 | 11 | 代码审查、线程安全、内存分析、机器人AI |
| 生产与监控 | 11 | 健康监控、日志记录、备份、安全 |
| VMap和MMap | 8 | 高度检测、寻路 |
| 配置和测试 | 8 | 配置管理、AI测试生成 |
基础工具（6个工具）
get-spell-info - Get detailed spell information by ID
get-item-info - Get item data by ID
get-quest-info - Get quest information by ID
query-dbc - Query DBC/DB2 file by record ID
get-trinity-api - Get TrinityCore C++ API documentation
get-opcode-info - Get network packet opcode documentation游戏桌工具（4个工具）
query-gametable - Query GameTable files (CombatRatings.txt, xp.txt, etc.)
list-gametables - List all available GameTable files
get-combat-rating - Get combat rating conversion for level
get-character-stats - Get character base stats for level工具使用示例
// Get spell information
const fireball = await callMCPTool("get-spell-info", { spellId: 133 });
// Analyze bot performance
const perf = await callMCPTool("analyze-bot-performance", {
duration: 60000,
sampleInterval: 1000
});
// Review C++ code
const review = await callMCPTool("review-code-file", {
filePath: "src/modules/Playerbot/BotAI.cpp",
minConfidence: 0.7
});
// Optimize quest route
const route = await callMCPTool("optimize-quest-route", {
zone: "Elwynn Forest",
level: 5
});有关完整的工具文档，请参阅上的Web UI API资源管理器http://localhost:3000/playground
______________________________________________________________________
Web用户界面
访问
启动Web UI：
# Start both MCP server and Web UI
npm run start:all
# Or start Web UI only
npm run start:web访问地址： http://localhost:3000
关键页面
- / -主页上有实时MCP状态和快速链接
- /游乐场 -交互式API游乐场测试所有107种工具
- /咒语 -搜索和过滤45000多种法术
- /项目 -通过筛选浏览项目数据库
- /生物 -探索NPC、供应商、培训师
- /仪表板 -带图表的分析仪表板
- /比较 -并排数据比较
- /代码审查 -AI驱动的C++代码审查
- /人工智能可视化器 -机器人AI行为分析
- /监测 -服务器健康监控
- /模式 -数据库架构浏览器
- /docs -完整的API文件
Web UI功能
✅ 36+互动页面 ✅ 107 MCP工具集成 ✅ 实时数据库访问 ✅ 高级搜索和筛选 ✅ 数据导出 （CSV、Excel、JSON、PDF、XML） ✅ AI代码审查 （1020条规则） ✅ 机器人AI可视化 （美人鱼流程图） ✅ 服务器监控 （实时指标） ✅ 深色模式 （针对开发进行了优化） ✅ 响应式设计 （台式机、平板电脑、手机）
______________________________________________________________________
文档
核心文件
- README.md -此文件（主要概述）
- 更改日志.md -版本历史和更改
- MCP_CONFIGURATION.md -详细的配置指南
- 安装.md -分步安装说明
Web UI文档
- web用户界面/README.md -Web UI特定文档
- API资源管理器 -互动文档http://localhost:3000/docs
开发文档
- doc/API_REFERENCE.md文件 -DBC/DB2 API参考
- doc/USAGE_GUIDE.md -使用指南和示例
- doc/KNOWN_LIMITATIONS.md -已知限制
______________________________________________________________________
发展
构建
# Build TypeScript to JavaScript
npm run build
# Watch mode (rebuild on changes)
npm run dev测试
# Run tests
npm test
# Or use MCP testing tools via Claude Code棉绒
npm run lint项目结构
trinitycore-mcp/
├── src/
│ ├── index.ts # Main MCP server entry point
│ ├── tools/ # 107 tool implementations (58 files)
│ │ ├── spell.ts
│ │ ├── item.ts
│ │ ├── quest.ts
│ │ ├── dbc.ts
│ │ ├── codereview.ts
│ │ ├── performance.ts
│ │ └── ... (52 more)
│ ├── database/
│ │ └── connection.ts # MySQL connection pool
│ ├── parsers/
│ │ ├── dbc/ # DBC/DB2 parsers
│ │ └── cache/ # Caching system
│ └── utils/
│ └── logger.ts
├── web-ui/ # Next.js 16 web interface
│ ├── app/ # App Router pages (36+ pages)
│ ├── components/ # React components
│ ├── lib/ # Utilities and MCP client
│ └── public/ # Static assets
├── data/
│ └── api_docs/ # 3,800+ API documentation files
├── tests/ # Test suites
├── dist/ # Compiled JavaScript (build output)
├── package.json # v0.9.0-RC1
├── tsconfig.json
└── README.md # This file______________________________________________________________________
贡献
欢迎投稿！请遵循TrinityCore编码标准。
开发工作流程
- 分叉存储库
- 创建要素分支：
git checkout -b feature/amazing-feature - 进行更改
- 构建和测试：
npm run build && npm test - 用描述性信息提交
- 推叉：
git push origin feature/amazing-feature - 打开拉取请求
代码质量标准
- ✅ TypeScript严格模式合规性
- ✅ 零编译错误/警告
- ✅ 全面的错误处理
- ✅ 公共API的JSDoc文档
- ✅ 新功能的单元测试
- ✅ 性能考虑
______________________________________________________________________
许可证
GPL-2.0 （与TrinityCore相同）
看 许可证 文件以获取详细信息。
______________________________________________________________________
支持
- 文档: doc/ 目录
- 问题:
- 三位一体核心: TrinityCore存储库
- MCP协议: 模型上下文协议
______________________________________________________________________
致谢
- 三一核心团队 -对于惊人的魔兽世界服务器框架
- 模型上下文协议 -对于MCP标准
- Anthropic -为Claude Code和AI提供帮助
- TypeScript团队 -对于优秀的语言
- Next.js团队 -对于React框架
- 维塞尔 -用于shadcn/ui组件
______________________________________________________________________
项目状态
版本：0.9.0-RC1（候选版本1） 状态: ✅ 生产就绪 MCP工具：107个注册工具 Web UI页面：36+交互式页面 最后更新: 2025-11-08
______________________________________________________________________
生成于 克劳德代码
合著者：Claude