convez.ai
MCP ServerProdutividadeIntermediário
DragonSnel

UnrealHelper

DragonSnel/UnrealHelper

Contexto completo do seu projeto UE5 direto no Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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/UnrealHelper

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 projects
  • app.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, .json and 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/FIXME comments
  • 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

  1. Run python run.py or python app.py
  2. In the sidebar, set the path to your Unreal project folder (the one containing the .uproject file)
  3. Click Save Path
  4. Click Start Server — the indicator will turn green
  5. 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

PlatformPath
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 stdio is included
  • Restart Claude Desktop fully
  • Verify project_path in config.json

On Windows, you may need:

set PYTHONIOENCODING=utf-8
Ver o original no GitHub

Bom para

Relacionados