trinitycore

TrinityCore MCP Server is an enterprise-grade platform that exposes 107 MCP tools for TrinityCore bot development and WoW 12.0 (Midnight). The server bundles a full-featured web UI built with Next.js to browse API data, run code reviews, simulate bot behavior, and query live databases. After starting the server, you can use the Web UI to navigate the API Explorer, run AI-powered code reviews, inspect game data (spells, items, quests, creatures,DBC/DB2, etc.), and perform performance profiling or bot scaling simulations. The tools are designed to help you analyze TrinityCore internals, generate bot components, and verify game data interactions with real-time feedback and detailed reports.

With the included 107 MCP tools, you can perform data lookups (e.g., spells, items, quests), run code analysis for C++ patterns, generate boilerplate bot components, test configurations, and monitor server health. The AI Code Review and Bot AI Visualizer provide insights into code quality and decision-making processes, while the Performance Profiler and Workflow Automation modules help optimize queries and automate development tasks. The web interface also supports data export formats (CSV, Excel, JSON, PDF, XML) for further analysis or sharing with your team.

Prerequisites:

• Node.js v18 or later
• npm (comes with Node.js) or use pnpm/yarn if preferred
• Git

Installation steps:

1. Clone the repository and install dependencies

git clone https://github.com/agatho/trinitycore-mcp.git
cd trinitycore-mcp
npm install

2. Build the TypeScript sources (server and UI)

npm run build

3. Start the MCP server along with the web UI

npm run start:all

4. Open the Web UI in your browser

• http://localhost:3000

Optional:

• If you deploy in production, consider building a production image or using a process manager (e.g., pm2) to keep the server running and manage restarts.

Tips and common considerations:

• The MCP server exposes a large suite of tools; start with the API Explorer and AI Code Review to understand capabilities before diving into data lookups.
• Ensure your environment has access to any required databases if you intend to run live MySQL queries via MCP; configure database connections in the UI or config files as needed.
• The web UI runs on port 3000 by default; you can adjust port settings through environment variables or startup scripts if hosting behind a reverse proxy.
• When upgrading, re-run npm install to refresh dependencies and rebuild to ensure compatibility with the latest MCP tool set.
• If you encounter permissions or network issues, verify firewall rules and ensure Node.js processes have the necessary system privileges.