Maya MCP

Servidor Maya MCP para Autodesk Maya

Maya MCP é um servidor de código aberto e local do Model Context Protocol para controlar o Autodesk Maya por meio do commandPort do Maya.

Versões suportadas do Maya: Autodesk Maya 2024 e posteriores.

Ele oferece aos clientes MCP uma superfície de ferramentas tipadas para trabalho com cenas, nós, seleção, modelagem, shading, skinning, animação, curvas, scripts e captura de viewport, sem importar módulos do Maya no processo do servidor.

Este projeto não é oficial e não é afiliado ou endossado pela Autodesk. Autodesk Maya é uma marca registrada da Autodesk, Inc.

Por que usar

• roda fora do Maya, então o servidor permanece isolado das importações do Maya
• comunica-se com o Maya apenas via localhost
• expõe 71 ferramentas tipadas em vez de chamadas brutas de API
• suporta fluxos de substituição de cena mais seguros para alterações não salvas
• deixa a execução de código bruto desabilitada, a menos que você opte por ativá-la

Início rápido com Claude Desktop

Para Claude Desktop, use a extensão MCPB empacotada do último lançamento do GitHub.

1. Baixe o maya-mcp-<version>.mcpb da seção Assets do lançamento.
2. Instale-o no Claude Desktop clicando duas vezes no arquivo .mcpb, arrastando-o para o Claude Desktop ou usando Configurações -> Extensões -> Configurações avançadas -> Instalar extensão.
3. Mantenha a configuração da porta de comando do Maya em 7001, a menos que você use uma porta diferente.
4. Abra o Maya e execute a configuração da porta de comando da próxima seção.
5. No Claude Desktop, verifique com health_check, scene_info e nodes_list.

O Claude Desktop usa nomes de ferramentas com sublinhado, como scene_info. Outros clientes MCP usam nomes com pontos, como scene.info.

Início rápido

1. Instalar

pip install maya-mcp

No Windows:

py -m pip install maya-mcp

A partir do código-fonte:

pip install -e ".[dev]"

2. Abrir o Maya commandPort

Baixe e, em seguida, cole e execute o arquivo completo scripts/enable_commandport.py no Editor de Scripts Python do Maya. O auxiliar mantém o caminho estabelecido de Python + echoOutput no Maya 2025 e posteriores. Apenas no Maya 2024, ele seleciona o caminho de compatibilidade de resposta somente loopback exigido por essa versão.

3. Iniciar o servidor

maya-mcp

Outros estilos de inicialização suportados:

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

fastmcp run funciona a partir deste repositório porque inclui fastmcp.json.

4. Adicionar ao seu cliente

Codex CLI / extensão IDE

O Codex usa ~/.codex/config.toml para servidores MCP. A CLI e a extensão IDE compartilham essa configuração.

Pacote instalado:

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

Checkout do código-fonte ou configuração amigável para Windows:

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

Use a linha PYTHONPATH somente ao executar a partir de um checkout do código-fonte. Use python em vez de py em plataformas que não fornecem o launcher do Windows.

Claude Code

Os servidores MCP de escopo de projeto do Claude Code ficam em .mcp.json. A chave do servidor é definida pelo usuário; estes exemplos usam maya de forma consistente.

Pacote instalado:

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

Checkout do código-fonte ou configuração amigável para Windows:

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

Para Codex CLI e Claude Code no Windows, py -m maya_mcp.server geralmente é mais confiável do que depender do script de console maya-mcp estar no PATH correto.

Extensão Claude Desktop

O Maya MCP é distribuído como uma extensão MCPB do Claude Desktop. A extensão ainda executa o mesmo servidor stdio local e mantém a comunicação com o Maya em localhost.

As notas de instalação do usuário, compilação, verificação e solução de problemas estão em Extensão Claude Desktop.

Os lançamentos publicados no GitHub anexam o pacote .mcpb compilado como maya-mcp-<version>.mcpb após o fluxo de trabalho de lançamento validar e testar o pacote.

O script de empacotamento suporta uma instalação CLI MCPB local do usuário:

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

VS Code

O VS Code usa .vscode/mcp.json com um objeto servers.

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

Outros clientes MCP

Alguns clientes usam um objeto mcpServers genérico:

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

5. Verificar

Chame estas ferramentas em ordem:

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

Cobertura de ferramentas

Família	Contagem
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á desabilitado por padrão e requer MAYA_MCP_ENABLE_RAW_EXECUTION=true.

scene.new e scene.open ainda recusam por padrão quando a cena atual tem alterações não salvas. Clientes que anunciam elicitação de formulário MCP podem receber uma confirmação de descarte de alterações em banda, em vez de precisar tentar novamente com force=True.

Documentação principal

• Início da documentação
• Começando
• Configuração do cliente
• Extensão Claude Desktop
• Guia de ferramentas
• Visão geral da arquitetura
• Especificação de transporte
• Especificação de segurança
• Política de privacidade
• Referência da API

Documentação publicada: https://gimbalgoats.github.io/GG_MayaMCP/

Desenvolvimento

Este repositório usa py para comandos Python no Windows:

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

Se os testes importarem maya_mcp de site-packages em vez deste repositório:

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

Notas de segurança

• somente localhost
• sem suporte a host remoto
• sem importações do Maya no processo do servidor MCP
• sem execução arbitrária de código por padrão
• sem segredos ou tracebacks brutos em erros voltados ao cliente

Privacidade

O Maya MCP roda localmente. O projeto não opera um serviço hospedado, não coleta telemetria nem recebe dados de cena do Maya de uso local. Consulte Política de privacidade.

Licença

MIT. Consulte LICENSE.