Maya MCP

Servidor Maya MCP para Autodesk Maya

Maya MCP es un servidor de Model Context Protocol local y de código abierto para controlar Autodesk Maya a través de commandPort de Maya.

Versiones de Maya compatibles: Autodesk Maya 2024 y posteriores.

Proporciona a los clientes MCP una superficie de herramientas tipadas para trabajo de escena, nodos, selección, modelado, sombreado, skinning, animación, curvas, scripts y captura de viewport sin importar módulos de Maya en el proceso del servidor.

Este proyecto no es oficial y no está afiliado ni respaldado por Autodesk. Autodesk Maya es una marca comercial de Autodesk, Inc.

Por qué usarlo

• se ejecuta fuera de Maya, por lo que el servidor permanece aislado de las importaciones de Maya
• se comunica con Maya solo a través de localhost
• expone 71 herramientas tipadas en lugar de llamadas API crudas
• admite flujos de reemplazo de escena más seguros para cambios no guardados
• deja la ejecución de código crudo deshabilitada a menos que optes por ella

Inicio rápido de Claude Desktop

Para Claude Desktop, usa la extensión MCPB empaquetada desde la última versión de GitHub.

1. Descarga maya-mcp-<version>.mcpb de la sección Assets de la versión.
2. Instálalo en Claude Desktop haciendo doble clic en el archivo .mcpb, arrastrándolo a Claude Desktop, o usando Configuración -> Extensiones -> Configuración avanzada -> Instalar extensión.
3. Mantén la configuración de commandPort de Maya en 7001 a menos que uses un puerto diferente.
4. Abre Maya y ejecuta la configuración de commandPort de la siguiente sección.
5. En Claude Desktop, verifica con health_check, scene_info y nodes_list.

Claude Desktop usa nombres de herramientas con guion bajo, como scene_info. Otros clientes MCP usan nombres con puntos, como scene.info.

Inicio rápido

1. Instalación

pip install maya-mcp

En Windows:

py -m pip install maya-mcp

Desde el código fuente:

pip install -e ".[dev]"

2. Abre Maya commandPort

Descarga, luego pega y ejecuta el archivo completo scripts/enable_commandport.py en el Editor de Scripts de Python de Maya. El asistente mantiene la ruta establecida de Python + echoOutput en Maya 2025 y posteriores. Solo en Maya 2024, selecciona la ruta de compatibilidad de respuesta solo de loopback requerida por esa versión.

3. Inicia el servidor

maya-mcp

Otros estilos de inicio compatibles:

python -m maya_mcp.server
python src/maya_mcp/server.py
fastmcp run

fastmcp run funciona desde este repositorio porque incluye fastmcp.json.

4. Añádelo a tu cliente

Extensión de Codex CLI / IDE

Codex usa ~/.codex/config.toml para servidores MCP. La CLI y la extensión del IDE comparten esa configuración.

Paquete instalado:

[mcp_servers.maya]
command = "maya-mcp"

Clonación del código fuente o configuración compatible con Windows:

[mcp_servers.maya]
command = "py"
args = ["-m", "maya_mcp.server"]
env = { PYTHONPATH = "src" }

Usa la línea PYTHONPATH solo cuando se ejecute desde una clonación del código fuente. Usa python en lugar de py en plataformas que no proporcionan el lanzador de Windows.

Claude Code

Los servidores MCP de ámbito de proyecto de Claude Code se encuentran en .mcp.json. La clave del servidor la define el usuario; estos ejemplos usan maya de manera consistente.

Paquete instalado:

{
  "mcpServers": {
    "maya": {
      "command": "maya-mcp",
      "args": []
    }
  }
}

Clonación del código fuente o configuración compatible con Windows:

{
  "mcpServers": {
    "maya": {
      "command": "py",
      "args": ["-m", "maya_mcp.server"],
      "env": {
        "PYTHONPATH": "src"
      }
    }
  }
}

Para Codex CLI y Claude Code en Windows, py -m maya_mcp.server suele ser más confiable que depender de que el script de consola maya-mcp esté en el PATH correcto.

Extensión de Claude Desktop

Maya MCP se distribuye como una extensión MCPB de Claude Desktop. La extensión sigue ejecutando el mismo servidor stdio local y mantiene la comunicación con Maya en localhost.

Las notas de instalación, compilación, verificación y solución de problemas del usuario se encuentran en Extensión de Claude Desktop.

Las versiones publicadas de GitHub adjuntan el paquete .mcpb compilado como maya-mcp-<version>.mcpb después de que el flujo de trabajo de la versión valide y pruebe el paquete.

El script de empaquetado admite una instalación de CLI MCPB local para el usuario:

npm install --prefix "$env:USERPROFILE\.tools\mcpb" @anthropic-ai/mcpb
.\packaging\claude-mcpb\build.ps1

VS Code

VS Code usa .vscode/mcp.json con un objeto servers.

{
  "servers": {
    "maya": {
      "type": "stdio",
      "command": "maya-mcp"
    }
  }
}

Otros clientes MCP

Algunos clientes usan un objeto mcpServers genérico:

{
  "mcpServers": {
    "maya": {
      "command": "maya-mcp",
      "args": []
    }
  }
}

5. Verificación

Llama a estas herramientas en orden:

1. health.check
2. scene.info
3. nodes.list

Cobertura de herramientas

Familia	Cantidad
health	1
maya	2
scene	9
nodes	7
attributes	2
selection	6
connections	5
mesh	3
viewport	1
modeling	15
shading	3
skin	6
animation	6
curve	2
script	3

script.run está deshabilitado por defecto y requiere MAYA_MCP_ENABLE_RAW_EXECUTION=true.

scene.new y scene.open aún se niegan por defecto cuando la escena actual tiene cambios no guardados. Los clientes que anuncian la elicitación de formularios MCP pueden recibir una confirmación de descarte de cambios en banda en lugar de tener que reintentar con force=True.

Documentación principal

• Inicio de documentación
• Primeros pasos
• Configuración del cliente
• Extensión de Claude Desktop
• Guía de herramientas
• Resumen de arquitectura
• Especificación de transporte
• Especificación de seguridad
• Política de privacidad
• Referencia de API

Documentación publicada: https://gimbalgoats.github.io/GG_MayaMCP/

Desarrollo

Este repositorio usa py para comandos de Python en Windows:

py -m ruff check .
py -m ruff format .
py -m mypy src/
py -m pytest

Si las pruebas importan maya_mcp desde site-packages en lugar de este repositorio:

$env:PYTHONPATH='src'
py -m pytest

Notas de seguridad

• solo localhost
• sin soporte para host remoto
• sin importaciones de Maya en el proceso del servidor MCP
• sin ejecución de código arbitrario por defecto
• sin secretos ni tracebacks crudos en errores visibles para el cliente

Privacidad

Maya MCP se ejecuta localmente. El proyecto no opera un servicio alojado, no recopila telemetría ni recibe datos de escenas de Maya del uso local. Consulta Política de privacidad.

Licencia

MIT. Consulta LICENSE.