Blender MCP Server

🚀 Blender MCP 服務器

Blender MCP 服務器是一個用於管理和執行 Blender 腳本的 Model Context Protocol (MCP) 服務器，它能幫助用戶方便地對 Blender Python 腳本進行添加、編輯、執行和刪除等操作，還能在無頭 Blender 環境中運行腳本並查看結果。

🚀 快速開始

1. 克隆此倉庫。
2. 安裝 MCP 庫：pip install mcp。
3. 確保 Blender 已安裝並可從 PATH 訪問。
4. 啟動服務器：

   python server.py
   

5. 使用 MCP 客戶端（如 Claude Desktop）連接到服務器。
6. 使用提供的工具管理腳本。
7. 訪問資源以獲取信息。

✨ 主要特性

• 添加、編輯、執行和刪除 Blender Python 腳本。
• 在無頭 Blender 環境中執行腳本。
• 查看執行結果和錯誤。
• 跟蹤腳本元數據（創建日期、上次修改日期、執行次數）。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝 MCP 庫：pip install mcp。
3. 確保 Blender 已安裝並可從 PATH 訪問。

💻 使用示例

基礎用法

# 添加一個簡單的腳本
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("創建了立方體！")
''')

# 執行腳本
execute_script("hello_cube")

# 獲取結果
# 使用以下地址訪問：result://hello_cube

高級用法

# 添加一個結合_blend文件的腳本
add_script("analyze_scene", '''
import bpy

# 打印當前場景的信息
print(f"當前 Blender 版本: {bpy.app.version_string}")
print(f"當前文件: {bpy.data.filepath}")

# 列出場景中的所有對象
print("\n場景中的對象:")
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

📚 詳細文檔

腳本管理工具

• 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} - 獲取腳本的執行結果。

🔧 技術細節

1. 添加腳本時，它會被存儲在 script_files/scripts 目錄中。
2. 執行腳本時，會在無頭 Blender 實例中運行：
   • 如果指定_blend 文件，則 Blender 會先打開該文件再執行腳本。
   • 否則，將使用默認的空 Blender 場景。
3. 輸出和錯誤會被捕獲並存儲在 script_files/results 目錄中。
4. 腳本元數據會在 script_files/metadata.json 中進行跟蹤。

📄 許可證

本項目採用 MIT 許可證。