UnrealHelper
DragonSnel/UnrealHelper
Contexto completo do seu projeto UE5 direto no Claude
Ver no GitHubMCP Server integrado com app desktop que potencia o desenvolvimento em Unreal Engine 5, permitindo que Claude acesse e analise seu projeto com contexto completo. Fornece 17 ferramentas para exploração de código C++, análise de Blueprints e busca no projeto, eliminando o trabalho manual de copiar código para chat.
Instalação
npx convez-ai DragonSnel/UnrealHelper1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise rápida de estrutura e dependências de projetos C++ em UE5
- Debugging assistido: encontrar TODOs, FIXMEs e padrões de código
- Exploração de Blueprints e configuração de projeto sem deixar o editor
- Geração de código com contexto real do projeto
Veredito

Ferramenta bem pensada para devs de Unreal Engine que querem aproveitar Claude com contexto real do projeto. A integração com Claude Desktop é suave e o app desktop oferece conveniência; limitada a UE5 mas executa bem seu nicho.
README
A tradução para o português deste README ainda está na fila.
⬡ UnrealHelper
UnrealHelper is a small tool I built to make working with Unreal Engine 5 and Claude AI way more convenient. Instead of constantly copying code into a chat window, Claude can directly read your project files, explore the structure, search through the codebase, and give answers with full context — almost like another developer who already knows your project.
The project includes two main components:
mcp_server.py— an MCP server that exposes 17 tools for analyzing UE5 projectsapp.py— a simple desktop app (CustomTkinter) for managing the server and chatting with Claude
✨ Features
MCP Tools (17 total)
These tools cover most of the common tasks you'd normally do manually:
- browse the project structure
- read
.h,.cpp,.ini,.jsonand other files - full-text search across the project
- analyze C++ files (classes, functions, includes)
- build a dependency graph for C++ files
- analyze Blueprints
- find
TODO/FIXMEcomments - diff between files
- built-in UE5 knowledge base (AI, inventory, networking, optimization, etc.)
- notes and prompt templates
Desktop App
The GUI makes it easy to:
- start/stop the MCP server
- chat with Claude directly
- save and load chat history
- quickly access project info
- manage the project path
- view logs in real time
- configure API key and model
- enjoy a small Unreal-style splash screen
🗂️ Project Structure
UnrealHelper/
├── mcp_server.py
├── app.py
├── run.py
├── requirements.txt
├── config.json
├── notes.json
├── chats.json
├── prompts.json
└── README.md
⚡ Quick Start
1. Clone the repository
git clone https://github.com/DragonSnel/UnrealHelper.git
cd UnrealHelper
2. Install dependencies
pip install -r requirements.txt
3. Run the app
python run.py
run.py checks your Python version (3.11+) and installs missing packages automatically.
🖥️ Using the Desktop App
- Run
python run.pyorpython app.py - In the sidebar, set the path to your Unreal project folder (the one containing the
.uprojectfile) - Click Save Path
- Click Start Server — the indicator will turn green
- Ask questions in the chat or use the quick-action buttons
The built-in chat uses the Anthropic API directly. For Claude Desktop integration, see below.
🔌 Connecting to Claude Desktop
This is the recommended way to use UnrealHelper. Claude Desktop gets access to all tools and can read your project automatically.
Step 1. Install Claude Desktop
Download it from: https://claude.ai/download
Step 2. Find the config file
| Platform | Path |
|---|---|
| Windows | %APPDATA%/Claude/claude_desktop_config.json |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Step 3. Add UnrealHelper to the config
{
"mcpServers": {
"UnrealHelper": {
"command": "python",
"args": ["C:/path/to/UnrealHelper/mcp_server.py", "--transport", "stdio"]
}
}
}
Step 4. Set the project path
Either through the GUI or manually in config.json:
{
"project_path": "C:/UE5Projects/MyAwesomeGame"
}
Step 5. Restart Claude Desktop
After restarting, the tools will appear automatically.
💬 Example Prompts
"Show me the structure of my Unreal project"
"Find all files that use BeginPlay"
"Read PlayerCharacter.h"
"List all TODO and FIXME comments"
"Which plugins are enabled?"
"Analyze EnemyController.cpp"
"Show a diff between two versions of a file"
"Give advice on designing an inventory system"
"Save a note: AI enemy needs a patrol Behavior Tree"
🛠️ Running the Server Manually
HTTP mode
python mcp_server.py --transport http --port 8765
stdio mode (for Claude Desktop)
python mcp_server.py --transport stdio
🧩 Extending the Functionality
Adding a new tool is as simple as writing one function:
@mcp.tool()
def my_new_tool(param: str) -> str:
root = _get_project_root()
return f"Result: {param}"
The UE5 knowledge base is stored in a dictionary, and prompt templates are saved in prompts.json.
📋 Requirements
- Python 3.11+
- fastmcp 2.0+
- customtkinter 5.2+
- Unreal Engine 5.x (5.3+ recommended)
- Claude Desktop (latest)
🐛 Troubleshooting
- Install missing packages (
fastmcp,customtkinter) - Check the path to
mcp_server.py - Ensure
--transport stdiois included - Restart Claude Desktop fully
- Verify
project_pathinconfig.json
On Windows, you may need:
set PYTHONIOENCODING=utf-8