merge from source

.gitignore

@@ -8,3 +8,9 @@ wheels/
 
 # Virtual environments
 .venv
+
+# macOS
+.DS_Store
+
+# Local config secrets
+src/blender_mcp/config.py

README.md

@@ -16,24 +16,25 @@ Give feedback, get inspired, and build on top of the MCP: [Discord](https://disc
 
 [CodeRabbit](https://www.coderabbit.ai/)
 
-[Satish Goda](https://github.com/satishgoda)
-
 **All supporters:**
 
 [Support this project](https://github.com/sponsors/ahujasid)
 
-## Release notes (1.2.0)
+## Current version(1.5.5)
+- Added Hunyuan3D support
 - View screenshots for Blender viewport to better understand the scene
 - Search and download Sketchfab models
-
-
-### Previously added features:
 - Support for Poly Haven assets through their API
 - Support to generate 3D models using Hyper3D Rodin
+- Run Blender MCP on a remote host
+- Telemetry for tools executed (completely anonymous)
+
+### Installating a new version (existing users)
 - For newcomers, you can go straight to Installation. For existing users, see the points below
 - Download the latest addon.py file and replace the older one, then add it to Blender
 - Delete the MCP server from Claude and add it back again, and you should be good to go!
 
+
 ## Features
 
 - **Two-way communication**: Connect Claude AI to Blender through a socket-based server
@@ -63,12 +64,14 @@ The system consists of two main components:
 brew install uv
 ```
 **On Windows**
-```bash
+```powershell
 powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 
 ```
-and then
-```bash
-set Path=C:\Users\nntra\.local\bin;%Path%
+and then add uv to the user path in Windows (you may need to restart Claude Desktop after):
+```powershell
+$localBin = "$env:USERPROFILE\.local\bin"
+$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")
 ```
 
 Otherwise installation instructions are on their website: [Install uv](https://docs.astral.sh/uv/getting-started/installation/)
@@ -106,10 +109,19 @@ Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json t
     }
 }
 ```
+<details>
+<summary>Claude Code</summary>
+
+Use the Claude Code CLI to add the blender MCP server:
+
+```bash
+claude mcp add blender uvx blender-mcp
+```
+</details>
 
 ### Cursor integration
 
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=blender&config=eyJjb21tYW5kIjoidXZ4IGJsZW5kZXItbWNwIn0%3D)
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/link/mcp%2Finstall?name=blender&config=eyJjb21tYW5kIjoidXZ4IGJsZW5kZXItbWNwIn0%3D)
 
 For Mac users, go to Settings > MCP and paste the following 
 
@@ -235,6 +247,37 @@ The system uses a simple JSON-based protocol over TCP sockets:
 - Complex operations might need to be broken down into smaller steps
 
 
+#### Telemetry Control
+
+BlenderMCP collects anonymous usage data to help improve the tool. You can control telemetry in two ways:
+
+1. **In Blender**: Go to Edit > Preferences > Add-ons > Blender MCP and uncheck the telemetry consent checkbox
+   - With consent (checked): Collects anonymized prompts, code snippets, and screenshots
+   - Without consent (unchecked): Only collects minimal anonymous usage data (tool names, success/failure, duration)
+
+2. **Environment Variable**: Completely disable all telemetry by running:
+```bash
+DISABLE_TELEMETRY=true uvx blender-mcp
+```
+
+Or add it to your MCP config:
+```json
+{
+    "mcpServers": {
+        "blender": {
+            "command": "uvx",
+            "args": ["blender-mcp"],
+            "env": {
+                "DISABLE_TELEMETRY": "true"
+            }
+        }
+    }
+}
+```
+
+All telemetry data is fully anonymized and used solely to improve BlenderMCP.
+
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

TERMS_AND_CONDITIONS.md

@@ -0,0 +1,176 @@
+# Blender MCP - Terms of Use and Privacy Policy
+
+**Last Updated: January 2025**
+
+---
+
+## 1. About This Project
+
+Blender MCP is a free, open-source project maintained by Siddharth Ahuja ("I," "me," "my"). This document describes how I collect and may use data when you use Blender MCP.
+
+By using Blender MCP, you agree to these terms. If you do not agree, please do not use the software.
+
+---
+
+## 2. Data I Collect
+
+When you use Blender MCP, I may collect:
+
+- **Prompts and text inputs** you provide to the AI
+- **Generated code** produced in response to your prompts
+- **Scene metadata** such as object names, modifier settings, and configurations
+- **Basic usage data** including timestamps and feature usage
+
+I do **not** collect:
+
+- Screenshots or images of your viewport
+- Your Blender files or 3D models
+- Personal files unrelated to your Blender session
+- Passwords or financial information
+- Data from other applications on your system
+
+---
+
+## 3. How I May Use Your Data
+
+I am currently collecting data for potential future use. This data may be used to:
+
+- **Train AI models** for 3D creation and Blender automation
+- **Improve Blender MCP** based on real-world usage
+- **Conduct research** on AI-assisted creative workflows
+- **Share datasets** with the research community (in anonymized or aggregated form)
+
+Your data may be:
+
+- Stored indefinitely
+- Used to train machine learning models in the future
+- Released as part of an open dataset (anonymized)
+
+---
+
+## 4. Data Sharing
+
+I may share collected data with:
+
+- **The open-source/research community** as part of public datasets
+- **Collaborators** working on AI or Blender-related research
+- **Legal authorities** if required by law
+
+I do not sell your data.
+
+---
+
+## 5. Your Rights
+
+You may:
+
+- **Request access** to the data I've collected from your usage
+- **Request deletion** of your data
+- **Opt out of telemetry** by unchecking the telemetry option in the Blender MCP addon preferences. When disabled, no data is collected, and you can continue using the software normally.
+
+To exercise these rights, contact me at ahujasid@gmail.com.
+
+**Important:** If data has been used to train an AI model or included in a public dataset, it may not be possible to fully remove it.
+
+---
+
+## 6. Data Retention
+
+- Data may be retained indefinitely
+- I will make reasonable efforts to honor deletion requests for unprocessed data
+- Anonymized or aggregated data may be retained and shared permanently
+
+---
+
+## 7. Security
+
+I take reasonable steps to protect collected data, but this is a solo open-source project, not a company with enterprise security infrastructure. I cannot guarantee absolute security.
+
+---
+
+## 8. Children
+
+Blender MCP is not intended for users under 16. I do not knowingly collect data from children.
+
+---
+
+## 9. International Users
+
+Your data may be stored and processed in any country. By using Blender MCP, you consent to international data transfers.
+
+---
+
+## 10. Intellectual Property
+
+### Your Content
+
+You retain ownership of your original creative work. By using Blender MCP with telemetry enabled, you grant me a **worldwide, royalty-free, perpetual license** to use:
+
+- Prompts you submit
+- Images/screenshots of your Blender viewport
+- Code generated in response to your prompts
+- Scene metadata captured during use
+
+This license is for AI training, research, open datasets, and improving the project.
+
+**Note:** When telemetry is disabled, no license is granted as no data is collected.
+
+### AI-Generated Content
+
+You may use AI-generated code however you like, but it's provided "as is" with no guarantees.
+
+### Blender MCP
+
+The Blender MCP source code is open source under its stated license. These terms apply only to data collection.
+
+---
+
+## 11. No Warranty
+
+BLENDER MCP IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES.
+
+I do not guarantee that:
+
+- The software will work correctly
+- AI-generated code will be safe or functional
+- Your data will be secure
+
+**You are responsible for reviewing any AI-generated code before using it.**
+
+---
+
+## 12. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, I AM NOT LIABLE FOR ANY DAMAGES ARISING FROM YOUR USE OF BLENDER MCP.
+
+This is a free, open-source project maintained in my spare time. Use at your own risk.
+
+---
+
+## 13. Changes
+
+I may update these terms at any time. Continued use of Blender MCP after changes means you accept the new terms.
+
+---
+
+## 14. Contact
+
+Questions or requests? Email me at ahujasid@gmail.com.
+
+---
+
+## 15. Consent
+
+By using Blender MCP with telemetry enabled, you acknowledge that:
+
+1. You have read and understood these terms
+2. You consent to the collection of prompts, generated code, images/screenshots, and scene metadata
+3. You understand this data may be used to train AI models or released as part of open datasets
+4. You understand that once data is used for training or released publicly, it cannot be fully deleted
+5. You are at least 16 years old
+6. You can disable telemetry at any time in the addon preferences
+
+---
+
+*Blender MCP is an independent project and is not affiliated with the Blender Foundation.*
+