Blender MCP Server

🚀 Blender MCP サーバー

このサーバーは、Blender スクリプトの管理と実行を行うための Model Context Protocol (MCP) サーバーです。Blender の Python スクリプトを簡単に操作でき、実行結果やエラーの確認、スクリプトのメタデータの追跡などの機能を提供します。

✨ 主な機能

• Blender Python スクリプトの追加、編集、実行、削除
• ヘッドレス Blender 環境でのスクリプト実行
• 実行結果とエラーの確認
• スクリプトのメタデータ（作成日、最終更新日、実行回数）の追跡

📦 インストール

1. このリポジトリをクローンします。
2. MCP ライブラリをインストールします: pip install mcp
3. Blender がインストールされ、PATH からアクセス可能であることを確認します。

🚀 クイックスタート

サーバーの起動

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_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

🔧 技術詳細

1. スクリプトを追加すると、script_files/scripts ディレクトリに保存されます。
2. スクリプトを実行すると、ヘッドレス Blender インスタンスで実行されます。
   • Blend ファイルが指定された場合、Blender はそのファイルを開いてからスクリプトを実行します。
   • そうでない場合、デフォルトの空の Blender シーンが使用されます。
3. 出力とエラーは script_files/results ディレクトリに保存されます。
4. スクリプトのメタデータは script_files/metadata.json で追跡されます。

📄 ライセンス

MIT