Blender MCP Server

Blender MCP Server

site icon
2025.03.05 7
PythonBlender 脚本管理Python 脚本执行开发效率
Blender MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于管理和执行 Blender Python 脚本。它提供了一个集中化的方式来添加、编辑、执行和移除 Blender 脚本,并支持在无头(headless)的 Blender 环境中运行脚本。该服务还允许用户查看脚本的执行结果和错误,并跟踪脚本的元数据,如创建日期、最后修改时间和执行次数。
View on GitHub

Overview

基本能力

产品定位

Blender MCP Server 是一个用于管理和执行 Blender Python 脚本的服务,旨在提高开发者在 Blender 环境中的工作效率。

核心功能

  • 添加、编辑、执行和移除 Blender Python 脚本
  • 在无头 Blender 环境中执行脚本
  • 查看脚本执行结果和错误
  • 跟踪脚本元数据(创建日期、最后修改时间、执行次数)

适用场景

  • 自动化 Blender 任务
  • 批量处理 Blender 项目
  • 开发和测试 Blender 脚本
  • 集成 Blender 脚本到其他工作流程中

工具列表

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

常见问题解答

  1. 如何查看可用脚本列表? 使用 scripts://list 获取可用脚本列表。
  2. 如何获取特定脚本的内容? 使用 script://{name} 获取特定脚本的内容。
  3. 如何获取脚本的执行结果? 使用 result://{name} 获取脚本的执行结果。

使用教程

使用依赖

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

安装教程

  1. 克隆此仓库
  2. 安装 MCP 库: pip install mcp
  3. 确保 Blender 已安装并可从 PATH 访问

调试方式

  1. 启动服务器: python server.py
  2. 使用 MCP 客户端(如 Claude Desktop)连接到服务器
  3. 使用提供的工具管理脚本

许可证

该项目遵循 MIT 开源许可条款。