Introdução geral
O BlenderMCP é uma ferramenta de código aberto que fornece um conjunto abrangente de ferramentas por meio do Modelo de protocolo de contexto (MCP) conecta o Blender ao protocolo Claude Conectividade com IA. Os usuários podem controlar o Blender diretamente com comandos de texto para criar e editar rapidamente modelos 3D, cenas e materiais. Adequada para designers, desenvolvedores e entusiastas de 3D, essa ferramenta aumenta consideravelmente a eficiência da modelagem. Ela inclui um plug-in do Blender e um servidor MCP que suporta comunicação bidirecional, manipulação de objetos e visualização de cenas, etc. O BlenderMCP está atualmente disponível gratuitamente no GitHub, e qualquer pessoa pode fazer o download ou participar de seu desenvolvimento.
Lista de funções
- comunicação bidirecionalInteração em tempo real entre o Claude AI e o Blender via servidor de soquete.
- manipulação de objetosCapacidade de criar, modificar ou excluir objetos 3D no Blender.
- Ajuste de materialSuporte para adicionar ou alterar materiais e cores aos objetos.
- Visualização da cenaObter informações detalhadas sobre a cena atual do Blender.
- execução de códigoExecutando código Python no Blender via Claude.
Usando a Ajuda
Processo de instalação
O BlenderMCP requer a instalação de duas partes: o plug-in do Blender e o servidor MCP. Veja a seguir as etapas específicas:
preliminar
- requisitos de softwareRequer Blender 3.0 ou superior e Python 3.10 ou superior.
- Baixar plug-insVisite a página do GitHub para fazer o download
addon.py
Documentação.
Instalando o plug-in do Blender
- Abra o Blender e clique no ícone Editar > Preferências > Plug-ins.
- strike (no teclado) montagem selecione o arquivo baixado
addon.py
Documentação. - Após a conclusão da instalação, localize o plug-in na lista de Interface: Blender MCP, marque Ativar.
Iniciando o servidor MCP
- Abra um terminal e digite o comando para iniciar o servidor:
uvx blender-mcp
- Se você estiver em um Mac, instale primeiro as ferramentas uv:
brew install uv
- Para usuários do Windows ou de outros sistemas, consulte site oficial da uv Obtenha o método de instalação.
Configuração do Claude Desktop Edition (opcional)
Se estiver usando a versão desktop do Claude, você pode fazer com que ele execute automaticamente o BlenderMCP da seguinte forma:
- Localize o caminho do arquivo de configuração:
- macOS.
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows.
%APPDATA%/Claude/claude_desktop_config.json
- Edite o arquivo para adicionar o seguinte:
{
"mcpServers": {
"blender": {
"comando": "uvx".
"args": ["blender-mcp"]
}
}
}
- Depois de salvo, o Claude iniciará automaticamente o servidor MCP quando necessário.
ativar uma conexão
- No Blender, pressione N abre a barra lateral da visualização 3D.
- localizar BlenderMCP Tab.
- Defina o número da porta, o padrão é 9876(Em geral, nenhuma alteração é necessária).
- strike (no teclado) Iniciar o servidor MCP Inicie o servidor dentro do plug-in.
- Verifique se o servidor MCP também está sendo executado no terminal (ou seja, ele executa o comando
uvx blender-mcp
).
Como usar os principais recursos
Depois que a conexão for bem-sucedida, você poderá operar o Blender inserindo comandos de texto por meio do Claude AI:
Exibir informações da cena
- diretrizesDigite "Get information about the current scene" (Obter informações sobre a cena atual).
- efeito: Chamada de Claude
get_scene_info
que retorna informações sobre o número e o local dos objetos na cena. - procedimentoComando: Digite um comando na interface Claude, aguarde alguns segundos e veja o resultado retornado.
Criação de objetos simples
- diretrizesTipo "Create a sphere and place it above the cube" (Crie uma esfera e coloque-a acima do cubo).
- efeito: através de
create_primitive
Se você quiser criar uma esfera, o Blender gera uma esfera e a coloca na parte superior do cubo. - procedimentoDepois de inserir os comandos, o Claude concluirá automaticamente a criação e você poderá ver o resultado no Blender.
Ajuste do material do objeto
- diretrizesDigite "Make this car red and metallic" (Faça este carro vermelho e metálico).
- efeito: Uso
set_material
responder cantandomodify_object
Em um ano, o carro foi substituído por um vermelho metálico. - procedimentoVerifique se há objetos de carro na cena e verifique se há alterações de material depois de inserir o comando.
Exclusão de objetos
- diretrizesDigite "Delete the cube" (Excluir o cubo).
- efeito: Chamada
delete_object
remove o cubo da cena. - procedimentoDepois de inserir o comando, volte ao Blender e confirme que o cubo desapareceu.
Executando o código Python
- diretrizes: Digite "Execute este código no Blender: bpy.ops.mesh.primitive_uv_sphere_add(radius=2, location=(0,0,5))".
- efeito: através de
execute_blender_code
No Blender, crie uma esfera com raio 2 e posição (0,0,5). - procedimentoDigite o comando completo e o Claude enviará o código para o Blender para execução. Observação: Salve o arquivo antes de executá-lo em caso de erros.
Criação de cenas complexas
- diretrizesTipo "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold" (Criar uma cena de baixo polígono em uma masmorra, com um dragão guardando um pote de ouro).
- efeitoO que é: Claude usa várias ferramentas passo a passo para gerar cenas de masmorras, dragões e potes de ouro com poucos polígonos.
- procedimentoAguarde alguns instantes após inserir o comando e o Blender exibirá a cena completa. Consulte .
fluxo de trabalho
- Início dos serviçosPressione a etapa "Start Connection" (Iniciar conexão) para garantir que o plug-in do Blender e o servidor MCP estejam em execução.
- entradaDigite a ação que deseja executar na interface do Claude, como criar objetos ou ajustar a iluminação.
- Confirmação dos resultadosSe o Blender não estiver funcionando, volte para o Blender e veja se a cena está sendo atualizada conforme as instruções.
- classificarSe ele não responder, abra o console do Blender (Window > Toggle Console) e verifique a mensagem de erro.
advertência
- Simplificação de mandatosInstruções complexas podem precisar ser divididas em etapas menores, como criar o objeto primeiro e depois modificar os atributos.
- Dicas de segurança: Uso
execute_blender_code
Tenha cuidado ao executar códigos desconhecidos para evitar o travamento do programa. - falha de conexãoSe não conseguir se conectar, verifique se o número da porta é o mesmo e se o firewall não a está bloqueando.
Com essas ações, você pode criar rapidamente modelos e cenas 3D no Blender com comandos de texto simples que economizam seu tempo e sua conveniência!
Descrição de uma frase (breve)
O BlenderMCP é uma ferramenta de código aberto que conecta o Blender e o Claude AI por meio do Model Context Protocol, permitindo que os usuários criem e modifiquem modelos 3D, cenas e materiais no Blender usando comandos de texto, com suporte para manipulação de objetos, ajustes de textura e execução de código Python, tornando-o ideal para gerar rapidamente conteúdo 3D de alta qualidade.