Unity Manual MCP

Servidor MCP local (stdio) que sirve una instalación local de la documentación de Unity a tu asistente de IA.

La carpeta de documentación suele estar ubicada en el directorio de instalación de Unity Editors, en Data\Documentation\en.

• Manual/ — artículos de tipo "cómo hacer", organizados en capítulos (~3.5k páginas)

• ScriptReference/ — referencia completa de la API de scripting, una página por clase / propiedad / método (~42k páginas)

En el primer inicio, el servidor crea un índice de texto completo SQLite de cada página (extracción del cuerpo del artículo al estilo Mozilla-Readability, se elimina el texto repetitivo y se conservan los ejemplos de código) y lo almacena en caché en el directorio temporal del sistema operativo. Los inicios posteriores lo reutilizan; se reconstruye automáticamente si cambia el número de archivos de documentación.

Requisitos

• uv

• Python 3.10+ — declarado en pyproject.toml (requerido por fastmcp 3.x). uv reutiliza cualquier Python ya instalado que cumpla este requisito y solo descarga uno nuevo si no existe un intérprete compatible.

Configuración

• Clona el repositorio

• Abre una terminal dentro del repositorio clonado

• Ejecuta

  uv sync

Crea .venv e instala las dependencias de pyproject.toml.

Ejecución

uv run server.py "C:\Program Files\Unity\Hub\Editor\<ver>\Editor\Data\Documentation\en"

La carpeta en se detecta automáticamente si apuntas a ...\Documentation o ...\Editor\Data en su lugar.

Opciones:

• --selftest — construye el índice y ejecuta consultas de muestra, luego sale (sin servidor MCP; útil para verificar una instalación nueva)

• --rebuild — fuerza la reconstrucción del índice

• --prune — elimina las entradas de caché obsoletas (archivo db inexistente) del manifiesto

• la variable de entorno UNITY_DOCS_PATH — alternativa al argumento posicional

ℹ Ejecuta el servidor manualmente una vez después de una instalación nueva para preindexar la documentación y evitar esperas durante el primer uso

uv run server.py --selftest "C:\Program Files\Unity\Hub\Editor\<ver>\Editor\Data\Documentation\en"

Añadir el servidor MCP

Es un servidor stdio, por lo que cualquier cliente que pueda lanzar un proceso local funciona. Cada cliente ejecuta el mismo comando:

uv run --directory "<repo>" server.py "<docs path>"

donde <repo> es la carpeta de este repositorio y <docs path> es tu carpeta en de la documentación de Unity (se detecta automáticamente si apuntas a ...\Documentation o ...\Editor\Data en su lugar). uv run crea y sincroniza el entorno .venv automáticamente, por lo que el cliente solo necesita uv en el PATH.

Claude Desktop

claude_desktop_config.json (sustituye tus propias rutas):

{
  "mcpServers": {
    "unity-manual": {
      "command": "uv",
      "args": ["run", "--directory", "<repo>", "server.py", "<docs path>"]
    }
  }
}

Claude Code

claude mcp add unity-manual -- uv run --directory "<repo>" server.py "<docs path>"

OpenCode

opencode.json en el proyecto, o la configuración global (~/.config/opencode/opencode.json):

{
  "mcp": {
    "unity-manual": {
      "type": "local",
      "command": ["uv", "run", "--directory", "<repo>", "server.py", "<docs path>"],
      "enabled": true
    }
  }
}

Codex

codex mcp add unity-manual -- uv run --directory "<repo>" server.py "<docs path>"

O edita ~/.codex/config.toml (compartido con la aplicación de escritorio ChatGPT y la extensión del IDE; un .codex/config.toml a nivel de proyecto funciona en proyectos de confianza):

[mcp_servers.unity-manual]
command = "uv"
args = ["run", "--directory", "<repo>", "server.py", "<docs path>"]

Herramientas

Todo de solo lectura (readOnlyHint):

Caché del índice

%TEMP%\unity-manual-mcp\ contiene un archivo db por editor (p. ej., <hash>.db) además de un manifest.json que asigna cada ruta de documentación a su archivo db. Cambiar de editor reutiliza el índice en caché; se valida por el número de archivos HTML. Elimina un archivo db (o usa --rebuild) para forzar una reconstrucción. --selftest informa de entradas **obsoletas** (archivo db inexistente) y entradas **huérfanas** (carpeta de documentación eliminada, db todavía presente); --prune elimina las obsoletas.

Créditos

Escrito íntegramente por Qwen 3.8 27b 🙂