iflow-mcp_cwahlfeldt_blender-mcp 0.1.0__tar.gz

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/.gitignore

@@ -0,0 +1 @@
+__pycache__

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/2985_process.log

@@ -0,0 +1,4 @@
+[2026-02-04 04:40:28] [SUCCESS] 获取项目: fork并克隆项目到本地成功，github_url=https://github.com/cwahlfeldt/blender-mcp, fork_github_url=https://github.com/iflow-mcp/cwahlfeldt-blender-mcp, name=cwahlfeldt-blender-mcp
+[2026-02-04 04:40:53] [SUCCESS] 阅读代码: 项目类型为Python MCP服务端项目，使用FastMCP框架，支持stdio协议，非SKILL项目，非MCP代理服务，项目未过期
+[2026-02-04 04:42:56] [SUCCESS] 本地测试: 构建和测试成功，修复了f-string语法错误，获取到4个工具(add_script, edit_script, execute_script, remove_script)，无需环境变量配置
+[2026-02-04 04:43:12] [SUCCESS] 推送iflow分支: 成功推送iflow分支到远程仓库 https://github.com/iflow-mcp/cwahlfeldt-blender-mcp

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_cwahlfeldt_blender-mcp
+Version: 0.1.0
+Summary: MCP server for executing Blender scripts
+Author: Blender MCP Team
+Requires-Python: >=3.11
+Requires-Dist: mcp>=0.1.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Blender MCP Server
+
+A Model Context Protocol (MCP) server for managing and executing Blender scripts.
+
+## Features
+
+- Add, edit, execute, and remove Blender Python scripts
+- Execute scripts in a headless Blender environment
+- View execution results and errors
+- Track script metadata (creation date, last modified, execution count)
+
+## Requirements
+
+- Python 3.7+
+- Blender installed and accessible
+- MCP library (`pip install mcp`)
+
+## Usage
+
+1. Start the server:
+   ```
+   python server.py
+   ```
+
+2. Connect to the server using an MCP client (like Claude Desktop)
+
+3. Use the provided tools to manage scripts:
+   - `add_script(name, content)` - Add a new script
+   - `edit_script(name, content)` - Edit an existing script
+   - `execute_script(name, blend_file=None)` - Execute a script in Blender, optionally specifying a .blend file
+   - `remove_script(name)` - Remove a script
+
+4. Access resources to get information:
+   - `scripts://list` - Get list of available scripts
+   - `script://{name}` - Get content of a specific script
+   - `result://{name}` - Get execution result of a script
+
+## Examples
+
+### Basic Example
+
+```python
+# Add a simple script
+add_script("hello_cube", '''
+import bpy
+
+# Clear existing objects
+bpy.ops.object.select_all(action='SELECT')
+bpy.ops.object.delete()
+
+# Create a cube
+bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))
+print("Cube created!")
+''')
+
+# Execute the script
+execute_script("hello_cube")
+
+# Get the result
+# Access using: result://hello_cube
+```
+
+### Working with Blend Files
+
+```python
+# Add a script that works with a blend file
+add_script("analyze_scene", '''
+import bpy
+
+# Print information about the current scene
+print(f"Current Blender version: {bpy.app.version_string}")
+print(f"Current file: {bpy.data.filepath}")
+
+# List all objects in the scene
+print("\\nObjects in the scene:")
+for obj in bpy.data.objects:
+    print(f" - {obj.name} ({obj.type})")
+''')
+
+# Execute with a specific blend file
+execute_script("analyze_scene", blend_file="/path/to/your/project.blend")
+
+# Get the result
+# Access using: result://analyze_scene
+```
+
+## How It Works
+
+1. When a script is added, it's stored in the `script_files/scripts` directory
+2. When executed, the script is run in a headless Blender instance
+   - If a blend file is specified, Blender will open that file before running the script
+   - Otherwise, a default empty Blender scene is used
+3. Output and errors are captured and stored in the `script_files/results` directory
+4. Metadata about scripts is tracked in `script_files/metadata.json`
+
+## Installation
+
+1. Clone this repository
+2. Install the MCP library: `pip install mcp`
+3. Ensure Blender is installed and accessible from your PATH
+
+## License
+
+MIT

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/README.md

@@ -0,0 +1,104 @@
+# Blender MCP Server
+
+A Model Context Protocol (MCP) server for managing and executing Blender scripts.
+
+## Features
+
+- Add, edit, execute, and remove Blender Python scripts
+- Execute scripts in a headless Blender environment
+- View execution results and errors
+- Track script metadata (creation date, last modified, execution count)
+
+## Requirements
+
+- Python 3.7+
+- Blender installed and accessible
+- MCP library (`pip install mcp`)
+
+## Usage
+
+1. Start the server:
+   ```
+   python server.py
+   ```
+
+2. Connect to the server using an MCP client (like Claude Desktop)
+
+3. Use the provided tools to manage scripts:
+   - `add_script(name, content)` - Add a new script
+   - `edit_script(name, content)` - Edit an existing script
+   - `execute_script(name, blend_file=None)` - Execute a script in Blender, optionally specifying a .blend file
+   - `remove_script(name)` - Remove a script
+
+4. Access resources to get information:
+   - `scripts://list` - Get list of available scripts
+   - `script://{name}` - Get content of a specific script
+   - `result://{name}` - Get execution result of a script
+
+## Examples
+
+### Basic Example
+
+```python
+# Add a simple script
+add_script("hello_cube", '''
+import bpy
+
+# Clear existing objects
+bpy.ops.object.select_all(action='SELECT')
+bpy.ops.object.delete()
+
+# Create a cube
+bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))
+print("Cube created!")
+''')
+
+# Execute the script
+execute_script("hello_cube")
+
+# Get the result
+# Access using: result://hello_cube
+```
+
+### Working with Blend Files
+
+```python
+# Add a script that works with a blend file
+add_script("analyze_scene", '''
+import bpy
+
+# Print information about the current scene
+print(f"Current Blender version: {bpy.app.version_string}")
+print(f"Current file: {bpy.data.filepath}")
+
+# List all objects in the scene
+print("\\nObjects in the scene:")
+for obj in bpy.data.objects:
+    print(f" - {obj.name} ({obj.type})")
+''')
+
+# Execute with a specific blend file
+execute_script("analyze_scene", blend_file="/path/to/your/project.blend")
+
+# Get the result
+# Access using: result://analyze_scene
+```
+
+## How It Works
+
+1. When a script is added, it's stored in the `script_files/scripts` directory
+2. When executed, the script is run in a headless Blender instance
+   - If a blend file is specified, Blender will open that file before running the script
+   - Otherwise, a default empty Blender scene is used
+3. Output and errors are captured and stored in the `script_files/results` directory
+4. Metadata about scripts is tracked in `script_files/metadata.json`
+
+## Installation
+
+1. Clone this repository
+2. Install the MCP library: `pip install mcp`
+3. Ensure Blender is installed and accessible from your PATH
+
+## License
+
+MIT

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/blender/__init__.py

@@ -0,0 +1 @@
+# blender module initialization

iflow_mcp_cwahlfeldt_blender_mcp-0.1.0/blender/executor.py

@@ -0,0 +1,160 @@
+import subprocess
+import os
+import tempfile
+from pathlib import Path
+import logging
+
+class BlenderExecutor:
+    """Class to handle script execution in Blender"""
+    
+    def __init__(self, blender_path=None, timeout=60):
+        """
+        Initialize the BlenderExecutor
+        
+        Args:
+            blender_path (str, optional): Path to the Blender executable. If None, will try to find it.
+            timeout (int, optional): Timeout for script execution in seconds
+        """
+        self.blender_path = blender_path or self._find_blender_executable()
+        self.timeout = timeout
+        self.temp_dir = Path(tempfile.gettempdir()) / "blender_mcp"
+        self._setup()
+    
+    def _setup(self):
+        """Setup the executor, create necessary directories"""
+        os.makedirs(self.temp_dir, exist_ok=True)
+    
+    def _find_blender_executable(self):
+        """Find Blender executable path"""
+        # Try common locations
+        common_paths = [
+            "blender",  # If it's in PATH
+            "/usr/bin/blender",
+            "/usr/local/bin/blender",
+            "/Applications/Blender.app/Contents/MacOS/Blender",
+            "C:\\Program Files\\Blender Foundation\\Blender\\blender.exe",
+        ]
+        
+        for path in common_paths:
+            try:
+                # Just check if we can run it with --version
+                subprocess.run([path, "--version"], 
+                               stdout=subprocess.PIPE, 
+                               stderr=subprocess.PIPE, 
+                               timeout=5)
+                return path
+            except (subprocess.SubprocessError, FileNotFoundError):
+                continue
+        
+        # If we couldn't find it, default to "blender" and hope it's in PATH
+        return "blender"
+    
+    def execute(self, script_name, script_content, blend_file=None):
+        """
+        Execute a script in Blender
+        
+        Args:
+            script_name (str): Name of the script
+            script_content (str): Content of the script to execute
+            blend_file (str, optional): Path to a .blend file to use
+            
+        Returns:
+            str: Output of the script execution
+        """
+        # Create a temporary script file
+        script_file = self.temp_dir / f"{script_name}.py"
+        output_file = self.temp_dir / f"{script_name}.out"
+        
+        # Prepare variables to avoid f-string backslash issues
+        output_file_str = str(output_file)
+        newlines = "\n\n"
+        
+        # Write the script content with output capture
+        with open(script_file, "w") as f:
+            # Add code to capture stdout and stderr
+            indented_script = script_content.replace('\n', '\n    ')
+            wrapped_script = f"""
+import sys
+import io
+import traceback
+
+# Redirect stdout and stderr
+old_stdout = sys.stdout
+old_stderr = sys.stderr
+stdout_buffer = io.StringIO()
+stderr_buffer = io.StringIO()
+sys.stdout = stdout_buffer
+sys.stderr = stderr_buffer
+
+try:
+    # Execute the script
+{indented_script}
+except Exception as e:
+    print(f"Error executing script: {{e}}")
+    traceback.print_exc()
+finally:
+    # Restore stdout and stderr
+    sys.stdout = old_stdout
+    sys.stderr = old_stderr
+    
+    # Write output to file
+    with open(r"{output_file_str}", "w") as output:
+        output.write(stdout_buffer.getvalue())
+        output.write("{newlines}")
+        output.write(stderr_buffer.getvalue())
+"""
+            f.write(wrapped_script)
+        
+        try:
+            # Run Blender with the script
+            cmd = [
+                self.blender_path,
+                "--background",  # Run without GUI
+            ]
+            
+            # Add blend file if provided
+            if blend_file:
+                if os.path.exists(blend_file):
+                    cmd.extend(["--file", blend_file])
+                else:
+                    return f"Error: Blend file not found: {blend_file}"
+            
+            # Add Python script
+            cmd.extend(["--python", str(script_file)])
+            
+            process = subprocess.run(
+                cmd,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                timeout=self.timeout,
+                text=True
+            )
+            
+            # Check if the output file exists
+            if output_file.exists():
+                with open(output_file, "r") as f:
+                    script_output = f.read()
+            else:
+                script_output = "No output captured from script."
+            
+            # Add Blender's stdout/stderr if there was an error
+            if process.returncode != 0:
+                script_output += "\n\nBlender process output:\n"
+                script_output += f"STDOUT: {process.stdout}\n"
+                script_output += f"STDERR: {process.stderr}"
+            
+            return script_output
+        
+        except subprocess.TimeoutExpired:
+            return f"Script execution timed out after {self.timeout} seconds"
+        except Exception as e:
+            return f"Error executing script: {str(e)}"
+        finally:
+            # Clean up temp files
+            try:
+                if script_file.exists():
+                    script_file.unlink()
+                if output_file.exists():
+                    output_file.unlink()
+            except Exception as e:
+                logging.warning(f"Failed to clean up temp files: {e}")