Hades — MCP Server para Unity no Claude Code
TheArcForge/hades-plugin
IA consciente de Unity: grafo de conhecimento + ferramentas MCP + skills de domínio
Ver no GitHubPlugin que integra Claude Code com projetos Unity através de um grafo de conhecimento queryável. Fornece 22 skills especializadas, 6 comandos de diagnóstico e 89 ferramentas MCP para assistência em arquitetura, redes, áudio, shaders, ECS e testes. Comunicação local via stdio-HTTP sem telemetria.
Instalação
npx convez-ai TheArcForge/hades-plugin1 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
- Assistência arquitetural em projetos Unity complexos
- Debugagem e validação de estrutura de projeto
- Orientação especializada em networking, audio, shaders e ECS
- Integração seamless entre Claude Code e editor Unity
Veredito

Solução sofisticada de MCP server para desenvolvedores Unity que querem contexto profundo do projeto no Claude Code. Requer Node.js 20+, macOS (Windows/Linux untestados) e a Unity Package correspondente — valor real apenas em fluxos de desenvolvimento Unity já estabelecidos.
README
A tradução para o português deste README ainda está na fila.
Hades — Claude Code Plugin
In the underworld of your Unity project, nothing is hidden from Hades.
This is the Claude Code plugin half of Hades — Unity-aware AI infrastructure that gives your agent a queryable knowledge graph of your project. It packages the skills, commands, and MCP connectivity that let Claude Code talk to the Hades server running inside Unity Editor.
Looking for what Hades is and why? Start at the main repository. This repo is a generated artifact — see the note at the bottom.
What this plugin provides
| Component | Count | Description |
|---|---|---|
| Skills | 22 | Architecture decisions, workflow guidance, domain expertise (networking, audio, UI, shaders, ECS, testing, and more) |
| Commands | 6 | /hades:status, /hades:rebuild-graph, /hades:show-traces, /hades:validate-memory, /hades:show-proposals, /hades:export-traces |
| MCP Server | 89 tools | Connects Claude Code to the Hades MCP server running inside Unity Editor |
Prerequisites
- macOS — currently the only tested platform. Windows and Linux are untested; reports welcome.
- Node.js 20+ — the MCP launcher and hub are Node.js processes
- Claude Code — install from claude.ai/download
- Hades Unity Package — installed in your Unity project (separate from this plugin; see the main repo)
Installation
Option A: Persistent install (recommended)
Register the Hades marketplace and install the plugin:
/plugin marketplace add TheArcForge/hades-plugin
/plugin install hades
This persists across sessions — you only do it once.
Option B: Per-session
claude --plugin-dir /path/to/hades-plugin
This loads the plugin for a single session only.
Verify
Run claude plugin validate /path/to/hades-plugin — you should see "Validation passed".
Usage
- Open your Unity project (with the Hades Unity Package installed).
cdinto your Unity project directory in your terminal.- Start Claude Code:
claude - Check the connection:
/hades:status
Skills activate automatically based on context. All 89 MCP tools are available when Unity is running.
How it connects
Claude Code → stdio → Launcher → HTTP → Hub → HTTP → Unity Editor
The Launcher (in Bridge~/launcher/) starts automatically with each Claude Code session. It connects to the Hub (in Bridge~/hub/), a lightweight HTTP server that runs once per machine and routes tool calls to the correct Unity Editor instance. The Hub auto-exits after 60 seconds with no connected sessions.
All communication is local. No cloud services, no telemetry.
Troubleshooting
| Symptom | Fix |
|---|---|
| No tools appear | Is Unity running? Did you cd into the Unity project dir? |
/hades:status not recognized | Plugin not installed. Re-run the install command. |
| Tools disappear after recompile | Wait ~10 seconds — Hub buffers during Unity domain reload. |
| Hub won't start | Run node --version to verify Node.js 20+. |
About this repository
This repository is generated from the TheArcForge/Hades source repo and published here for the Claude Code marketplace. Do not submit pull requests here — open issues and PRs against the main repository instead. See its CONTRIBUTING.md for details.
License
MIT