Blender MCP 服务器

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

功能

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

要求

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

用法

1. 启动服务器：

   python server.py
   

2. 使用 MCP 客户端（如 Claude Desktop）连接到服务器

3. 使用提供的工具来管理脚本：

   • add_script(name, content) - 添加新脚本
   • edit_script(name, content) - 编辑现有脚本
   • execute_script(name, blend_file=None) - 在 Blender 中执行脚本，可以选择指定一个 .blend 文件
   • remove_script(name) - 删除脚本

4. 访问资源以获取信息：

   • scripts://list - 获取可用脚本列表
   • script://{name} - 获取特定脚本的内容
   • result://{name} - 获取脚本的执行结果

示例

基本示例

# 添加一个简单的脚本
add_script("hello_cube", '''
import bpy

# 清除现有对象
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()

# 创建一个立方体
bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))
print("Cube created!")
''')

# 执行脚本
execute_script("hello_cube")

# 获取结果
# 使用以下方式访问：result://hello_cube

使用 Blend 文件

# 添加一个使用 blend 文件的脚本
add_script("analyze_scene", '''
import bpy

# 打印有关当前场景的信息
print(f"Current Blender version: {bpy.app.version_string}")
print(f"Current file: {bpy.data.filepath}")

# 列出场景中的所有对象
print("\\nObjects in the scene:")
for obj in bpy.data.objects:
    print(f" - {obj.name} ({obj.type})")
''')

# 使用特定的 blend 文件执行
execute_script("analyze_scene", blend_file="/path/to/your/project.blend")

# 获取结果
# 使用以下方式访问：result://analyze_scene

工作原理

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

安装

1. 克隆此存储库
2. 安装 MCP 库：pip install mcp
3. 确保已安装 Blender 并且可以从您的 PATH 访问

许可证

MIT