AI导哈

Blender场景管理工具集

为Blender 5.1+提供的47种场景管理工具，包括网格操作、视口捕获、导入/导出和摄影测量地形处理，替代基础社区版Blender MCP。

  • by jenkinsm13
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jenkinsm13/better-blender-mcp

使用说明

更好的搅拌机mcp

适用于Blender 5.1+的MCP服务器，配备47个工具，用于场景管理、网格操作、视口捕获、导入/导出和摄影测量地形处理。用适当的工具覆盖率替换基本的社区Blender MCP。

需求

  • 搅拌机5.1+
  • Python 3.11+和 紫外线
  • Claude 代码

安装

1.安装克劳德代码插件

# Add the marketplace (one-time)
claude plugin marketplace add https://github.com/jenkinsm13/claude-plugins

# Install the plugin
claude plugin install better-blender-mcp

或手动注册：

claude mcp add --scope user blender-mcp -- uv run --directory /path/to/better-blender-mcp blender-mcp

2.将FastMCP安装到Blender的Python中

Blender自带Python——必须安装FastMCP：

# macOS
/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3 -m pip install fastmcp

# Linux
/path/to/blender/5.1/python/bin/python3 -m pip install fastmcp

# Windows
"C:\Program Files\Blender Foundation\Blender 5.1\5.1\python\bin\python.exe" -m pip install fastmcp

3.安装Blender插件

将插件源代码符号链接到Blender的插件目录中：

# macOS
ln -s /path/to/better-blender-mcp/src/blender_mcp \
      ~/Library/Application\ Support/Blender/5.1/scripts/addons/blender_mcp

# Linux
ln -s /path/to/better-blender-mcp/src/blender_mcp \
      ~/.config/blender/5.1/scripts/addons/blender_mcp

# Windows (run as admin)
mklink /D "%APPDATA%\Blender Foundation\Blender\5.1\scripts\addons\blender_mcp" \
       C:\path\to\better-blender-mcp\src\blender_mcp

然后在Blender中启用： 首选项>附加组件>搜索“Blender MCP”>启用.

用法

  1. 打开搅拌机
  2. 在3D视口侧栏中（按 N)，找到 搅拌机MCP 标签
  3. 点击 启动MCP服务器 （在端口8800上运行）
  4. 启动Claude Code——它通过stdio代理自动连接

建筑学

Claude Code  ──stdio──>  proxy.py  ──HTTP──>  FastMCP server (inside Blender)
                                                    │
                                              ExecutionQueue
                                                    │
                                              bpy.app.timers (main thread)

MCP服务器直接运行在Blender的进程中 bpy 访问。stdio到HTTP代理将Claude Code桥接到服务器。所有工具调用都通过 ExecutionQueue Blender的主线是 bpy.app.timers，在哪里 bpy.ops 并且可以获得完整的上下文。

工具（47）

类别 工具
场景 get_scene_info, list_objects, get_object_info, select_objects, delete_objects, create_collection, move_to_collection, set_active_object, execute_python
网格 get_mesh_stats, clean_mesh, decimate_mesh, smooth_mesh, separate_loose, boolean_operation, bisect_mesh, remove_faces, project_uv, create_vertex_group, classify_surfaces, compute_envelope
视口 capture_viewport, capture_viewport_4pack, set_viewport_shading, frame_objects, set_viewport_overlay
导入/导出 import_obj, import_fbx, import_ply, export_obj, export_fbx, export_ply, batch_import, batch_export, export_kn5 （存根）， export_kpm （存根）
修饰符 add_modifier, apply_modifier, apply_all_modifiers, remove_modifier
变换 get_transforms, apply_transforms, set_origin, align_objects
项目 open_file, save_file, get_project_state

视口捕获

capture_viewport --将活动的3D视口截图为PNG。

capture_viewport_4pack --捕捉俯视图、前视图、右视图和透视图，拼接成2x2网格。非常适合在单张图像中从各个角度查看模型。

瓷砖命名约定

命名对象 Tile_X-Y （例如。， Tile_0-0, Tile_3-2)被视为摄影测量地形图块。除非满足以下条件，否则阻止对平铺对象进行变换修改 force=True 以防止意外错位。

许可证

麻省理工学院

相关 MCP