TrinityCore MCP服务器

![Build](https://github.com/agatho/trinitycore-mcp/actions/workflows/build.yml) ![Code Quality](https://github.com/agatho/trinitycore-mcp/actions/workflows/code-quality.yml) ](https://github.com/agatho/trinitycore-mcp/releases) ![License](LICENSE) ![TypeScript](https://www.typescriptlang.org/) ](https://nodejs.org/) ![MCP Tools](src/index.ts)

企业级模型上下文协议服务器 提供 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:all

Web 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=localhost

Claude代码集成

增添 .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

Trinitycore MCP

快速接入

详细介绍

TrinityCore MCP服务器

🚀 快速开始

📋 目录

概述

特性

核心MCP服务器（107个工具）

游戏数据和查询（40个工具）

战斗与优化（12个工具）

经济与社会（8种工具）

小组协调和PvP（8个工具）

收藏与调平（7个工具）

知识库和代码生成（12个工具）

性能与测试（9个工具）

数据库工具（11个工具）

AI代码审查和分析（11个工具）

生产与监控（11种工具）

VMap和MMap工具（8个工具）

配置和测试生成（8个工具）

Web用户界面（Next.js 16）

核心功能

数据浏览器

分析和工具

开发者工具

工作流和数据管理

UI功能

安装

先决条件

安装步骤

Web UI安装

配置

环境变量

Claude代码集成

用法

启动MCP服务器和Web UI（推荐）

单独启动服务

仅限MCP服务器

仅限Web UI

MCP工具（共107个）

按类别快速参考

基础工具（6个工具）

游戏桌工具（4个工具）

工具使用示例

Web用户界面

访问

关键页面

Web UI功能

文档

核心文件

Web UI文档

开发文档

发展

构建

测试

棉绒

项目结构

贡献

开发工作流程

代码质量标准

许可证

支持

致谢

项目状态

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP