IA by DNACX

#6 no GitHub · Design e computador

Como instalar e usar o MCP for Blender

Um servidor MCP que conecta a IA ao Blender, o programa de modelagem 3D. A IA pode criar e alterar objetos, materiais, cenas e iluminação, e olhar o resultado para conferir o próprio trabalho.

Para quem
Quem usa o Blender e quer criar ou ajustar cenas 3D conversando com a IA.
Estrelas (07/11/2026)
33.534, #6 no ranking
Licença
MIT
Repositório
ahujasid/mcp-for-blender

Passo a passo

Antes de começar: Blender 3.0 ou mais novo; Python 3.10 ou mais novo; uv (gerenciador de pacotes; o instalador do README o instala se faltar); Um cliente MCP; o README cita Claude Desktop, Claude Code, Codex, Cursor e VS Code.

  1. Instale uv e o addon do Blender

    O README oferece um comando único que instala o uv, encontra os clientes MCP da máquina, deixa você escolher quais configurar, instala o addon no Blender e o ativa. Ele executa um script baixado da internet.

    Comando
    curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

  2. Alternativa sem script (se já tem uv)

    Quem prefere não rodar o script, ou já tem o uv, usa este comando.

    Comando
    uvx mcp-for-blender setup

  3. Ou adicione só o servidor ao Claude Code

    Na instalação manual, o README traz este comando para registrar o servidor no Claude Code.

    Comando
    claude mcp add blender uvx mcp-for-blender

  4. Instale o addon no Blender (instalação manual)

    Rode o comando e depois, no Blender, vá em Edit, Preferences, Add-ons e ative 'Interface: MCP for Blender'.

    Comando
    uvx mcp-for-blender install-addon

  5. Reinicie o aplicativo de IA e abra o Blender

    O README manda sair totalmente do aplicativo de IA e abrir de novo. O addon inicia seu servidor quando o Blender abre.

  6. Confira a conexão no Blender

    Aperte N na vista 3D e abra a aba 'MCP for Blender'. Se o servidor não estiver rodando, clique em 'Start MCP Server'.

  7. Peça algo simples

    Com tudo ligado, peça uma cena básica. O README diz que você verá um ícone de martelo com as ferramentas no cliente.

Primeiro teste

Numa sessão com o servidor conectado, cole:

Primeiro teste
Create a sphere and place it above the cube

O README lista este pedido entre os exemplos do que dá para pedir. Ele não descreve o resultado exato.

Cuidados

  • Por padrão a IA pode rodar qualquer código Python no Blender. O README diz: 'By default, the AI can run any Python code in Blender.'
  • O modo seguro verifica cada script antes de rodar e bloqueia coisas como ler ou escrever arquivos diretamente, executar outros programas, acessar a rede ou instalar código que continua rodando depois do script. Para ligar, defina BLENDER_MCP_SAFE_MODE=1.
  • O aviso do README sobre a ferramenta execute_blender_code: 'ALWAYS save your work before using it.' (salve seu trabalho antes de usar).
  • O servidor interno do addon não tem autenticação nem criptografia. Quem alcançar a porta pode rodar Python no Blender. O README manda manter em localhost e preferir túnel SSH a abrir para a rede.
  • Telemetria: o README diz que o conteúdo (prompts, código gerado, capturas, dados da cena) só é coletado se você optar. Por padrão há um registro anônimo mínimo de uso. Para desligar tudo, defina DISABLE_TELEMETRY=true.
  • Rode só uma instância do servidor (Cursor ou Claude Desktop), não as duas.
  • Alguns recursos de geração de modelos 3D usam serviços externos com chave própria; o README diz, por exemplo, que a chave da Meshy exige um plano pago. Poly Haven baixa modelos, texturas e HDRIs e pode ser desligado na caixa do Blender.
  • O README avisa que é uma integração de terceiros, não feita pelo Blender.

Como desfazer

O README não traz passo de remoção. Ele diz que o instalador guarda cópia .bak dos arquivos de configuração que altera.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • Preço do serviço Premium e das chaves de cada gerador de modelos 3D.
  • Quais dados exatamente o registro anônimo mínimo envia além da lista do README.
  • Como remover o addon e o servidor.
  • Se o seu Blender específico é compatível.

Dúvidas

Posso desligar a execução livre de Python?

O README oferece o modo seguro, ligado por BLENDER_MCP_SAFE_MODE=1, que bloqueia scripts arriscados e devolve o motivo à IA para ela tentar de novo.

O instalador mexe nas minhas configurações?

O README diz que mantém a configuração existente, só adiciona uma entrada 'blender' e salva um .bak de cada arquivo que altera.

De onde vêm os modelos 3D gerados?

O README cita Meshy, Tripo, Hyper3D Rodin e Hunyuan3D, além de bibliotecas como Poly Haven, Sketchfab e Poly Pizza.

O nome mudou?

Sim. O README diz que o pacote blender-mcp agora se chama mcp-for-blender e que as configurações antigas continuam funcionando.

A DNACX usa o MCP for Blender?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #5 GitHub MCP Server · #7 Code Review Graph →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de ahujasid/mcp-for-blender, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.