Servidor MCP de Unity

Un servidor de Protocolo de Contexto de Modelo (MCP) para el desarrollo de juegos de Unity, que permite a los asistentes de IA interactuar con proyectos de Unity a través de un conjunto de herramientas especializadas.

Descripción general

El servidor MCP de Unity conecta los asistentes de IA (como Cursor AI o Claude) con los proyectos de Unity. Ofrece herramientas para:

Lectura y búsqueda de archivos en proyectos de Unity
Análisis de escenas y prefabricados de Unity
Analizar código C# y detectar errores
Ejecución de pruebas automatizadas en modo por lotes
Generar scripts a partir de plantillas
Validación de sombreadores
Y más...

El servidor está diseñado para ejecutarse con Unity en modo por lotes, lo que permite realizar operaciones que requieren el motor Unity sin necesidad de la GUI del editor.

Instalación

Prerrequisitos

Node.js 16+
Unity 2022.3 LTS o más reciente (recomendado)

Configuración

Clonar este repositorio:
git clone https://github.com/GrandMasterK414/unity-smithery-mcp.git cd unity-smithery-mcp
Instalar dependencias:
npm install
Construir el proyecto:
npm run build

Configuración

El servidor utiliza el paquete config para la configuración. Edite config/default.json para ajustar la configuración:

{
  "server": {
    "port": 3000,
    "host": "0.0.0.0"
  },
  "unity": {
    "unityPath": "/path/to/Unity/Editor/Unity",
    "projectPath": "/path/to/your/unity/project",
    "timeoutMs": 60000,
    "batchMode": true
  },
  "logging": {
    "level": "info",
    "file": "logs/mcp-server.log",
    "maxSize": 5242880,
    "maxFiles": 5
  },
  "security": {
    "allowedPaths": ["Assets", "ProjectSettings", "Packages"],
    "disallowedCommands": ["rm", "del", "format", "shutdown"]
  }
}

Uso

Iniciando el servidor

npm start

Para ejecutar en modo Herrería:

npm run smithery:start

Uso con asistentes de IA

Este servidor está diseñado principalmente para trabajar con asistentes de IA mediante las herramientas definidas en la especificación MCP. Para la integración con Cursor o Smithery.ai, consulte su documentación para conectarse a este servidor MCP.

Herramientas disponibles

Nombre de la herramienta	Descripción
`open_file`	Lee el contenido de un archivo en el proyecto de Unity
`search_files`	Busca patrones de texto en archivos de proyecto
`list_assets`	Enumera los activos del proyecto de un determinado tipo o en una carpeta
`get_project_info`	Obtiene información de alto nivel sobre el proyecto Unity
`parse_scene`	Analiza un archivo de escena de Unity para extraer la jerarquía de objetos del juego
`parse_prefab`	Analiza un archivo prefabricado de Unity para extraer componentes
`find_in_scenes`	Encuentra escenas que contienen un GameObject o componente específico
`analyze_cs_code`	Compila código C# para encontrar errores del compilador
`find_references`	Encuentra referencias a una clase o método de C#
`generate_script`	Crea un nuevo archivo de script de C# a partir de una plantilla
`validate_shader`	Compila un sombreador y reporta errores
`inspect_yaml`	Inspecciona un archivo de activos YAML
`run_tests`	Ejecuta las pruebas automatizadas de Unity en modo por lotes
`simulate_playmode`	Experimental: ejecuta una escena en modo de reproducción durante un período breve.

Soporte de Docker

Se incluye un Dockerfile para la implementación en contenedores. Cree la imagen de Docker:

docker build -t unity-mcp-server .

Ejecute el contenedor:

docker run -p 3000:3000 -v /path/to/unity/project:/project unity-mcp-server

Integración de Smithery.ai

Este servidor se puede implementar en Smithery.ai utilizando la configuración smithery.yaml proporcionada.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios.

Unity MCP Server

Integrations