Sobre o projeto

MCP para Blender é um plugin comunitário que conecta o Blender 3D a qualquer LLM (como Claude, Codex ou Cursor) através do Protocolo de Contexto de Modelo (MCP). Ele permite criar, modificar e manipular cenas 3D usando prompts de linguagem natural. ## Principais Recursos - **Comunicação bidirecional**: Conecte assistentes de IA ao Blender via um servidor baseado em socket - **Manipulação de objetos**: Crie, modifique e exclua objetos 3D - **Controle de materiais**: Aplique e modifique materiais e cores - **Execução de código**: Execute código Python arbitrário no Blender a partir da IA - **Geração de assets e modelos**: Importe de Poly Haven, Sketchfab, Poly Pizza e modelos gerados por IA via Hyper3D Rodin e Hunyuan3D ## Como Funciona O plugin consiste em duas partes principais: 1. **Servidor MCP** (`src/blender_mcp/server.py`) - Um servidor Python que implementa o Protocolo de Contexto de Modelo 2. **Addon do Blender** - Um painel lateral no viewport 3D do Blender que inicia a conexão ## Configuração 1. Instale o `uv` (o gerenciador de pacotes Python) usando o instalador oficial 2. Instale o addon do Blender (via linha de comando ou manualmente nas preferências do Blender) 3. Configure seu cliente MCP (Claude Desktop, Claude Code, Codex, Cursor, VS Code, etc.) 4. No Blender, pressione `N` para abrir a barra lateral, encontre a aba **MCP para Blender** e clique em **Iniciar Servidor MCP** ## Capacidades - Execute qualquer código Python no Blender - Baixe modelos, assets e HDRIs do Poly Haven - Pesquise e baixe modelos do Sketchfab - Pesquise e baixe modelos low-poly do Poly Pizza - Gere modelos 3D através do Hyper3D Rodin e Hunyuan3D (Tencent Cloud) ## Exemplos de Comandos - "Crie uma cena low poly em uma masmorra, com um dragão guardando um pote de ouro" - "Forneça uma imagem de referência e crie uma cena do Blender a partir dela" - "Gere um modelo 3D de um gnomo de jardim através do Hyper3D" - "Preencha esta sala com móveis low-poly do Poly Pizza" ## Configuração Variáveis de ambiente permitem personalização: - `BLENDER_HOST` (padrão: `localhost`) - `BLENDER_PORT` (padrão: `9876`) - `BLENDER_MCP_SAFE_MODE` - Defina como `1` para validar scripts antes da execução ## Considerações de Segurança - O servidor socket do addon não tem autenticação ou criptografia - Por padrão, a IA pode executar qualquer código Python no Blender - O modo seguro (`BLENDER_MCP_SAFE_MODE=1`) bloqueia operações arriscadas como I/O de arquivos, acesso à rede ou instalação persistente de código ## Credenciais de API Persistentes Armazene chaves de API para Sketchfab, Poly Pizza, Hyper3D e Hunyuan3D nas preferências do Blender ou via variáveis de ambiente para configurações headless/CI. ## Suporte a Docker O servidor MCP pode rodar em um contêiner em vez de ser instalado localmente. O Blender ainda roda na sua máquina; o contêiner apenas hospeda o servidor MCP e se conecta ao addon do Blender. ## Aviso Esta é uma integração de terceiros e não é feita pelo Blender.