BlenderMCP

Conecta o Blender a modelos de IA via MCP para modelagem 3D, criação de cenas e manipulação assistidas por prompt.

GitHub
11
Experimente este MCPPatrocinado

Documentação

BlenderMCP - Integração do Blender com o Model Context Protocol

smithery badge Blender-mcp

para vídeo de demonstração clique aqui

O BlenderMCP conecta o Blender ao Claude AI e ao cursor através do Model Context Protocol (MCP), permitindo que o Claude e o cursor interajam diretamente e controlem o Blender. Essa integração possibilita modelagem 3D assistida por prompt, criação de cenas e manipulação.

Notas de versão (1.1.0)

  • Adicionado suporte para ativos do Poly Haven através da API deles
  • Adicionado suporte para solicitar modelos 3D usando Hyper3D Rodin
  • Para iniciantes, você pode ir direto para Instalação. Para usuários existentes, veja os pontos abaixo
  • Baixe o arquivo addon.py mais recente e substitua o antigo, depois adicione-o ao Blender
  • Exclua o servidor MCP do Claude e adicione-o novamente, e você estará pronto para usar!

Recursos

  • Comunicação bidirecional: Conecte o Claude AI ao Blender através de um servidor baseado em socket
  • Manipulação de objetos: Crie, modifique e exclua objetos 3D no Blender
  • Controle de materiais: Aplique e modifique materiais e cores
  • Inspeção de cena: Obtenha informações detalhadas sobre a cena atual do Blender
  • Execução de código: Execute código Python arbitrário no Blender a partir do Claude

Componentes

O sistema consiste em dois componentes principais:

  1. Addon do Blender (addon.py): Um addon do Blender que cria um servidor socket dentro do Blender para receber e executar comandos
  2. Servidor MCP (src/blender_mcp/server.py): Um servidor Python que implementa o Model Context Protocol e se conecta ao addon do Blender

Instalação

Pré-requisitos

  • Blender 3.0 ou mais recente
  • Python 3.10 ou mais recente
  • gerenciador de pacotes uv:

Se você estiver no Mac, instale o uv como

brew install uv

No Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

e depois

set Path=C:\Users\nntra\.local\bin;%Path%

Caso contrário, as instruções de instalação estão no site deles: Instalar uv

⚠️ Não prossiga antes de instalar o UV

Instalando via Smithery

Para instalar o Blender Integration Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @Gorav22/blender-mcp --client claude

Integração com Claude for Desktop

Vá para Claude > Configurações > Desenvolvedor > Editar Config > claude_desktop_config.json para incluir o seguinte:

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

Integração com Cursor

Para usuários de Mac, vá para Configurações > MCP e cole o seguinte

  • Para usar como servidor global, use o botão "adicionar novo servidor MCP global" e cole
  • Para usar como servidor específico do projeto, crie .cursor/mcp.json na raiz do projeto e cole
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Para usuários do Windows, vá para Configurações > MCP > Adicionar Servidor, adicione um novo servidor com as seguintes configurações:

{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": [
                "/c",
                "uvx",
                "blender-mcp"
            ]
        }
    }
}

⚠️ Execute apenas uma instância do servidor MCP (no Cursor ou no Claude Desktop), não ambos

Instalando o Addon do Blender

  1. Baixe o arquivo addon.py deste repositório
  2. Abra o Blender
  3. Vá para Editar > Preferências > Add-ons
  4. Clique em "Instalar..." e selecione o arquivo addon.py
  5. Ative o addon marcando a caixa ao lado de "Interface: Blender MCP"

Uso

Iniciando a Conexão

  1. No Blender, vá para a barra lateral da Visualização 3D (pressione N se não estiver visível)
  2. Encontre a aba "BlenderMCP"
  3. Ative a caixa de seleção do Poly Haven se quiser ativos da API deles (opcional)
  4. Clique em "Conectar ao Claude"
  5. Certifique-se de que o servidor MCP está rodando no seu terminal

Usando com o Claude

Depois que o arquivo de configuração for definido no Claude e o addon estiver rodando no Blender, você verá um ícone de martelo com ferramentas para o Blender MCP.

Capacidades

  • Obter informações de cena e objeto
  • Criar, excluir e modificar formas
  • Aplicar ou criar materiais para objetos
  • Executar qualquer código Python no Blender
  • Baixar os modelos, ativos e HDRIs corretos através do Poly Haven
  • Modelos 3D gerados por IA através do Hyper3D Rodin

Integração Hyper3D

A chave de teste gratuita do Hyper3D permite gerar um número limitado de modelos por dia. Se o limite diário for atingido, você pode aguardar a redefinição do dia seguinte ou obter sua própria chave em hyper3d.ai e fal.ai.

Solução de Problemas

  • Problemas de conexão: Certifique-se de que o servidor do addon do Blender está rodando e que o servidor MCP está configurado no Claude. NÃO execute o comando uvx no terminal. Às vezes, o primeiro comando não passa, mas depois começa a funcionar.
  • Erros de tempo limite: Tente simplificar suas solicitações ou dividi-las em etapas menores
  • Integração com Poly Haven: O Claude às vezes é errático em seu comportamento
  • Você já tentou desligar e ligar novamente?: Se ainda estiver tendo erros de conexão, tente reiniciar tanto o Claude quanto o servidor do Blender

Detalhes Técnicos

Protocolo de Comunicação

O sistema usa um protocolo simples baseado em JSON sobre sockets TCP:

  • Comandos são enviados como objetos JSON com um type e opcional params
  • Respostas são objetos JSON com um status e result ou message

Limitações e Considerações de Segurança

  • A ferramenta execute_blender_code permite executar código Python arbitrário no Blender, o que pode ser poderoso, mas potencialmente perigoso. Use com cautela em ambientes de produção. SEMPRE salve seu trabalho antes de usá-la.
  • O Poly Haven requer o download de modelos, texturas e imagens HDRI. Se você não quiser usá-lo, desative-o na caixa de seleção no Blender.
  • Operações complexas podem precisar ser divididas em etapas menores

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Aviso Legal

Esta é uma integração de terceiros e não feita pelo Blender. Feita por Gorav Jindal