# 3D Agent MCP - Blender Integration
## 🎯 Overview
A Model Context Protocol (MCP) server that enables AI models like Claude to interact with Blender for 3D modeling, scene manipulation, and rendering tasks. This agent bridges the gap between natural language instructions and complex 3D operations in Blender.
## ✨ Features
- **3D Object Creation**: Generate primitive shapes and complex meshes via natural language
- **Scene Manipulation**: Move, rotate, scale, and modify objects programmatically
- **Material & Texturing**: Apply and modify materials, textures, and shaders
- **Rendering Control**: Configure and execute renders with custom settings
- **Animation Support**: Create and control keyframe animations
- **File Operations**: Import/export various 3D formats (OBJ, FBX, GLB, etc.)
- **Python Scripting**: Execute custom Blender Python scripts through the MCP interface
## 🚀 Quick Start
### Prerequisites
- Python 3.8 or higher
- Blender 3.0+ installed on your system
- Claude Desktop or any MCP-compatible client
### Installation
1. Clone the repository:git clone https://github.com/rishithakar-07/3d_agent_mcp.git cd 3d_agent_mcp/blender-mcp-main
2. 安装依赖项：
pip install -r requirements.txt
3. （如需）配置Blender路径：
Set your Blender executable path
export BLENDER_PATH="/path/to/blender"
### 运行MCP服务器
python server.py
服务器将在默认的MCP端口启动并等待连接。
## 💡 使用示例
### 基本对象创建
Request to the MCP agent:
"Create a red cube at position (2, 0, 1) with size 2"
Agent handles:
- Creates mesh primitive
- Applies material
- Sets transform properties
### 复杂场景构建
Request:
"Build a simple room with 4 walls, a floor, and a point light"
Agent handles:
- Multiple object creation
- Proper positioning
- Lighting setup
### 渲染
Request:
"Render the current scene at 1920x1080 with cycles engine"
Agent handles:
- Render engine configuration
- Resolution settings
- Output file management
## 🏗️ 建筑学
blender-mcp-main/ ├── server.py # Main MCP server implementation ├── blender_ops.py # Blender operation handlers ├── mcp_tools.py # MCP tool definitions ├── utils/ # Utility functions ├── requirements.txt # Python dependencies └── examples/ # Example scripts and scenes
## 🛠️ MCP 工具可用
- `create_object` - 创建3D基本体和网格
- `transform_object` - 移动、旋转、缩放对象
- `apply_material` - 添加和修改材料
- `render_scene` - 配置并执行渲染
- `import_file` - 导入3D模型
- `export_scene` - 导出为多种格式
- `execute_script` - 运行自定义的Blender Python代码
## 🔧 配置
通过编辑来配置MCP服务器 `config.json`:
{ "blender_path": "/path/to/blender", "default_engine": "cycles", "output_directory": "./renders", "max_polygon_count": 1000000 }
## 📚 与Claude的集成
在您的Claude桌面配置中添加：
{ "mcp_servers": { "blender-3d": { "command": "python", "args": ["/path/to/3d_agent_mcp/blender-mcp-main/server.py"], "description": "3D modeling and rendering with Blender" } } }
## 🎨 使用场景
- **快速原型制作**通过对话快速创建3D模型
- **教育内容**生成用于学习的3D可视化效果
- **资产生成**为游戏或应用程序创建3D资产
- **建筑可视化**构建并渲染建筑场景
- **动画创作**通过自然语言开发简单动画
- **批处理**自动化重复的3D任务
## 🤝 贡献（或“参与贡献”）
欢迎贡献！请随时提交拉取请求或就错误报告和功能请求打开问题。
## 👤 作者
**里希·塔卡尔**
- GitHub： [@rishithakar-07（这个用户名或标签在中文中通常保持不变，直接翻译可能无实际意义，故保留原样）](https://github.com/rishithakar-07)
## 🙏 致谢
- 使用模型上下文协议（MCP）规范构建
- 由Blender的Python API提供支持
- 受创建易于获取的3D内容需求的启发
- 使用现有的Blender MCP仓库
______________________________________________________________________
*该项目展示了人工智能语言模型与专业3D软件的集成，展现了自然语言驱动3D内容创作的潜力。*