Blender

Name: Blender
Author: ahujasid

@ahujasid

代码仓库主页

关于 Blender

Open-source MCP to use Blender with any LLM

#blender #3d-modeling #ai-integration

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

ahujasid

提交者

idoubi

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Get detailed information about the current Blender scene

Get detailed information about a specific object in the Blender scene. Parameters: - object_name: The name of the object to get information about

Capture a screenshot of the current Blender 3D viewport. Parameters: - max_size: Maximum size in pixels for the largest dimension (default: 800) Returns the screenshot as an Image.

Execute arbitrary Python code in Blender. Make sure to do it step-by-step by breaking it into smaller chunks. Parameters: - code: The Python code to execute

Get a list of categories for a specific asset type on Polyhaven. Parameters: - asset_type: The type of asset to get categories for (hdris, textures, models, all)

Search for assets on Polyhaven with optional filtering. Parameters: - asset_type: Type of assets to search for (hdris, textures, models, all) - categories: Optional comma-separated list of categories to filter by Returns a list of matching assets with basic information.

Download and import a Polyhaven asset into Blender. Parameters: - asset_id: The ID of the asset to download - asset_type: The type of asset (hdris, textures, models) - resolution: The resolution to download (e.g., 1k, 2k, 4k) - file_format: Optional file format (e.g., hdr, exr for HDRIs; jpg, png for textures; gltf, fbx for models) Returns a message indicating success or failure.

Apply a previously downloaded Polyhaven texture to an object. Parameters: - object_name: Name of the object to apply the texture to - texture_id: ID of the Polyhaven texture to apply (must be downloaded first) Returns a message indicating success or failure.

Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available.

Check if Hyper3D Rodin integration is enabled in Blender. Returns a message indicating whether Hyper3D Rodin features are available. Don't emphasize the key type in the returned message, but sliently remember it.

Check if Sketchfab integration is enabled in Blender. Returns a message indicating whether Sketchfab features are available.

Search for models on Sketchfab with optional filtering. Parameters: - query: Text to search for - categories: Optional comma-separated list of categories - count: Maximum number of results to return (default 20) - downloadable: Whether to include only downloadable models (default True) Returns a formatted list of matching models.

Download and import a Sketchfab model by its UID. Parameters: - uid: The unique identifier of the Sketchfab model Returns a message indicating success or failure. The model must be downloadable and you must have proper access rights.

Generate 3D asset using Hyper3D by giving description of the desired asset, and import the asset into Blender. The 3D asset has built-in materials. The generated model has a normalized size, so re-scaling after generation can be useful. Parameters: - text_prompt: A short description of the desired model in **English**. - bbox_condition: Optional. If given, it has to be a list of floats of length 3. Controls the ratio between [Length, Width, Height] of the model. Returns a message indicating success or failure.

Generate 3D asset using Hyper3D by giving images of the wanted asset, and import the generated asset into Blender. The 3D asset has built-in materials. The generated model has a normalized size, so re-scaling after generation can be useful. Parameters: - input_image_paths: The **absolute** paths of input images. Even if only one image is provided, wrap it into a list. Required if Hyper3D Rodin in MAIN_SITE mode. - input_image_urls: The URLs of input images. Even if only one image is provided, wrap it into a list. Required if Hyper3D Rodin in FAL_AI mode. - bbox_condition: Optional. If given, it has to be a list of ints of length 3. Controls the ratio between [Length, Width, Height] of the model. Only one of {input_image_paths, input_image_urls} should be given at a time, depending on the Hyper3D Rodin's current mode. Returns a message indicating success or failure.

Check if the Hyper3D Rodin generation task is completed. For Hyper3D Rodin mode MAIN_SITE: Parameters: - subscription_key: The subscription_key given in the generate model step. Returns a list of status. The task is done if all status are "Done". If "Failed" showed up, the generating process failed. This is a polling API, so only proceed if the status are finally determined ("Done" or "Canceled"). For Hyper3D Rodin mode FAL_AI: Parameters: - request_id: The request_id given in the generate model step. Returns the generation task status. The task is done if status is "COMPLETED". The task is in progress if status is "IN_PROGRESS". If status other than "COMPLETED", "IN_PROGRESS", "IN_QUEUE" showed up, the generating process might be failed. This is a polling API, so only proceed if the status are finally determined ("COMPLETED" or some failed state).

Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: - name: The name of the object in scene - task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step. - request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step. Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully.

概览

What is Blender?

BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender for prompt-assisted 3D modeling, scene creation, and manipulation.

How to use Blender?

Install prerequisites (Blender 3.0+, Python 3.10+, uv), download the addon.py file and install it in Blender (Edit > Preferences > Add-ons), then configure the MCP server in your client’s config file (Claude Desktop, Cursor, VS Code, etc.). In Blender, open the 3D View sidebar, find the BlenderMCP tab, optionally enable Poly Haven, and click “Connect to Claude”. The server connects via the host and port specified by environment variables BLENDER_HOST (default localhost) and BLENDER_PORT (default 9876).

Key features of Blender

Two-way communication between Claude AI and Blender via sockets
Object manipulation: create, modify, and delete 3D objects
Material control: apply and modify materials and colors
Scene inspection: get detailed information about the current Blender scene
Code execution: run arbitrary Python code in Blender from Claude
Support for Poly Haven assets, Sketchfab downloads, and AI‑generated 3D models (Hyper3D Rodin, Hunyuan3D)

Use cases of Blender

Create a low poly dungeon scene with a dragon guarding treasure
Build a beach scene using HDRIs, textures, and models from Poly Haven
Generate a 3D model from a reference image or text prompt
Modify object materials (e.g., “make this car red and metallic”)
Point the camera and set isometric views for the scene

FAQ from Blender

What are the system requirements?

Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager (install via brew install uv on macOS, or the official installer on Windows/Linux). On locked‑down machines, pipx can be used as an alternative.

How does communication between Claude and Blender work?

The system uses a simple JSON‑based protocol over TCP sockets. The Blender addon runs a socket server that receives commands; the MCP server implements the Model Context Protocol and sends commands to that socket.

How can I troubleshoot connection issues?

Ensure the Blender addon server is running and the MCP server is configured in your client. Do not run the uvx command manually in the terminal while the client is active. If problems persist, restart both Claude and the Blender server. For timeout errors, try simplifying requests or breaking them into smaller steps.

What security considerations should I be aware of?

The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. Use with caution.

How do I configure persistent API credentials?

Credentials for Sketchfab, Hyper3D, and Hunyuan3D can be stored in Blender’s Add‑on Preferences (Edit > Preferences > Add‑ons > Blender MCP) so they survive restarts. Alternatively, for headless setups, use environment variables like BLENDERMCP_SKETCHFAB_API_KEY, BLENDERMCP_HYPER3D_API_KEY, etc.