Blender MCP 服务器

用于管理和执行 Blender 脚本的模型上下文协议 (MCP) 服务器。

特征

添加、编辑、执行和删除 Blender Python 脚本
在无头 Blender 环境中执行脚本
查看执行结果和错误
跟踪脚本元数据（创建日期、上次修改、执行次数）

Related MCP server: MCP Server Python Template

要求

Python 3.7+
Blender 已安装并可访问
MCP 库 ( pip install mcp )

用法

启动服务器：
python server.py
使用 MCP 客户端（如 Claude Desktop）连接到服务器
使用提供的工具来管理脚本：
- add_script(name, content) - 添加新脚本
- edit_script(name, content) - 编辑现有脚本
- execute_script(name, blend_file=None) - 在 Blender 中执行脚本，可选择指定 .blend 文件
- remove_script(name) - 删除脚本
访问资源以获取信息：
- scripts://list - 获取可用脚本列表
- script://{name} - 获取特定脚本的内容
- result://{name} - 获取脚本的执行结果

示例

基本示例

# Add a simple script add_script("hello_cube", ''' import bpy # Clear existing objects bpy.ops.object.select_all(action='SELECT') bpy.ops.object.delete() # Create a cube bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0)) print("Cube created!") ''') # Execute the script execute_script("hello_cube") # Get the result # Access using: result://hello_cube

使用混合文件

# Add a script that works with a blend file add_script("analyze_scene", ''' import bpy # Print information about the current scene print(f"Current Blender version: {bpy.app.version_string}") print(f"Current file: {bpy.data.filepath}") # List all objects in the scene print("\\nObjects in the scene:") for obj in bpy.data.objects: print(f" - {obj.name} ({obj.type})") ''') # Execute with a specific blend file execute_script("analyze_scene", blend_file="/path/to/your/project.blend") # Get the result # Access using: result://analyze_scene

工作原理

添加脚本后，它将存储在script_files/scripts目录中
执行时，脚本在无头 Blender 实例中运行
- 如果指定了混合文件，Blender 将在运行脚本之前打开该文件
- 否则，使用默认的空 Blender 场景
输出和错误被捕获并存储在script_files/results目录中
有关脚本的元数据在script_files/metadata.json中跟踪