Blender MCP — Casos de uso, Instalar & Demo ao vivo

Name: Blender MCP MCP Server
Author: ahujasid

Por que usar

Principais recursos

Execução direta de bpy — qualquer coisa que você possa scriptar, o Claude pode controlar
Introspecção de cena: listar objetos, obter propriedades, inspecionar materiais
Integração PolyHaven: buscar e importar HDRIs, texturas e modelos
Hyper3D rodin: gerar modelos 3D por IA a partir de texto ou imagem
Busca no Sketchfab integrada para navegação de modelos gratuitos

Demo ao vivo

Como fica na prática

blender-mcp-ahujasid.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Blender MCP

Construir uma cena 3D a partir de um prompt de texto sem tocar na interface do Blender

👤 Designers, devs indie, entusiastas que não modelam com fluência ⏱ ~30 min beginner

Quando usar: Você quer um mockup rápido de cena 3D mas não quer aprender atalhos do Blender.

Pré-requisitos

Blender 3.0+ instalado — Baixe em blender.org
Addon Blender MCP habilitado — Edit > Preferences > Add-ons > Install from disk

Fluxo

Conectar o Claude ao Blender

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ Copiado

→ Cena vazia listada (Cube, Camera, Light) confirmando conexão ao vivo
Compor a cena

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ Copiado

→ Objetos aparecem na viewport em tempo real
Adicionar atmosfera

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ Copiado

→ Cena agora tem atmosfera iluminada; névoa visível no render

Resultado: Uma cena 3D de protótipo construída inteiramente pelo chat, pronta para refinamento.

Armadilhas

O Blender desconecta no meio da sessão — Reconecte pelo painel N; o addon escuta em um socket local

Gerar assets 3D com Hyper3D rodin e importar diretamente

👤 Devs de games e prototipadores que precisam de iteração rápida de assets ⏱ ~20 min intermediate

Quando usar: Você precisa de uma prop única e não quer modelar do zero nem pagar por assets de marketplace.

Pré-requisitos

API key do Hyper3D rodin (plano gratuito disponível) — Cadastre-se em hyper3d.ai; defina HYPER3D_RODIN_API_KEY

Fluxo

Gerar a partir de prompt

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ Copiado

→ Job de geração iniciado; mesh importado quando concluído (~30s)
Refinar e reimportar se necessário

The mesh is too dense. Decimate to 5k tris and reimport.✓ Copiado

→ Mesh decimado substitui o original

Resultado: Prop 3D customizada na cena, gerada e ajustada sem sair do Claude.

Armadilhas

Fila de geração sobrecarregada no plano gratuito — Tente novamente com backoff exponencial ou faça upgrade do plano

Executar operações em lote em muitos objetos via bpy

👤 TDs e engenheiros de pipeline ⏱ ~25 min advanced

Quando usar: Você precisa de uma ação em massa tediosa — renomear hierarquia, redirecionar materiais, fazer UV unwrap em lote.

Fluxo

Descrever a operação

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ Copiado

→ O Claude escreve o snippet bpy e pede confirmação antes de executar
Executar com rede de segurança

Show me the script first. If it looks safe, execute. Otherwise revise.✓ Copiado

→ Script visível; execução aplicada; relatório de quantos objetos foram afetados

Resultado: Operações em lote na cena concluídas em segundos com trilha de auditoria completa.

Armadilhas

Script ruim trava o Blender — Salve antes de qualquer execução bpy; o addon não tem sandbox

Combinações

Combine com outros MCPs para 10× de alavancagem

blender-mcp-ahujasid + filesystem

Salvar renders e exports em disco

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
execute_blender_code	code: str	Qualquer operação bpy direta	0
get_scene_info	()	Primeira chamada para entender o que está na cena	0
get_object_info	name: str	Inspecionar um objeto específico antes de editar	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	Encontrar assets PBR gratuitos	0
polyhaven_download_asset	asset_id, resolution	Baixar e aplicar HDRI/textura	0
generate_hyper3d_model_via_text	prompt: str	Gerar modelo 3D por IA	1 crédito de geração

Custo e limites

O que custa rodar

Cota de API: PolyHaven: ilimitado e gratuito. Hyper3D: plano gratuito ~20 gerações/dia
Tokens por chamada: 100–800 por chamada (o estado da cena pode ser verboso)
Monetário: Addon gratuito. Planos pagos do Hyper3D a partir de $10/mês
Dica: Use Sketchfab e PolyHaven antes de pagar pelas gerações do Hyper3D

Segurança

Permissões, segredos, alcance

Escopos mínimos: blender-bpy-exec filesystem-write (para downloads)

Armazenamento de credenciais: Chave do Hyper3D em variável de ambiente

Saída de dados: CDN do PolyHaven, API do Hyper3D

execute_blender_code executa Python arbitrário no seu Blender — revise antes de rodar scripts desconhecidos

Solução de problemas

Erros comuns e correções

Conexão recusada

Certifique-se de que o Blender está aberto e o 'Connect to Claude' do addon está ativo; porta padrão 9876

Geração do Hyper3D travada

Verifique a variável de ambiente HYPER3D_RODIN_API_KEY; confira a cota do plano em hyper3d.ai

Objeto não encontrado após edição

O nome do objeto pode ter sufixo numérico (.001) — use get_scene_info para atualizar

Alternativas

Blender MCP vs. outros

Alternativa	Quando usar	Troca
Unity MCP / Unreal MCP	Seu pipeline é primariamente de game engine, não DCC	MCPs de engine focam em runtime/cena; Blender MCP foca em autoria
Cesium MCP	Você precisa de 3D geoespacial em escala mundial	Cesium é para cenas georeferenciadas; Blender é de forma livre

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills