3d_agent_mcp

rishithakar-07/3d_agent_mcp

3.2

If you are the rightful owner of 3d_agent_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

3D Agent MCP - Blender Integration is a server that allows AI models to interact with Blender for 3D tasks.

Tools
7
Resources
0
Prompts
0
# 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:
```bash
git clone https://github.com/rishithakar-07/3d_agent_mcp.git
cd 3d_agent_mcp/blender-mcp-main
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure Blender path (if needed):
# Set your Blender executable path
export BLENDER_PATH="/path/to/blender"

Running the MCP Server

python server.py

The server will start on the default MCP port and wait for connections.

šŸ’” Usage Examples

Basic Object Creation

# 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

Complex Scene Building

# Request:
"Build a simple room with 4 walls, a floor, and a point light"

# Agent handles:
- Multiple object creation
- Proper positioning
- Lighting setup

Rendering

# Request:
"Render the current scene at 1920x1080 with cycles engine"

# Agent handles:
- Render engine configuration
- Resolution settings
- Output file management

šŸ—ļø Architecture

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 Tools Available

  • create_object - Create 3D primitives and meshes
  • transform_object - Move, rotate, scale objects
  • apply_material - Add and modify materials
  • render_scene - Configure and execute renders
  • import_file - Import 3D models
  • export_scene - Export to various formats
  • execute_script - Run custom Blender Python code

šŸ”§ Configuration

Configure the MCP server by editing config.json:

{
  "blender_path": "/path/to/blender",
  "default_engine": "cycles",
  "output_directory": "./renders",
  "max_polygon_count": 1000000
}

šŸ“š Integration with Claude

Add to your Claude Desktop configuration:

{
  "mcp_servers": {
    "blender-3d": {
      "command": "python",
      "args": ["/path/to/3d_agent_mcp/blender-mcp-main/server.py"],
      "description": "3D modeling and rendering with Blender"
    }
  }
}

šŸŽØ Use Cases

  • Rapid Prototyping: Quickly create 3D mockups through conversation
  • Educational Content: Generate 3D visualizations for learning
  • Asset Generation: Create 3D assets for games or applications
  • Architectural Visualization: Build and render architectural scenes
  • Animation Creation: Develop simple animations through natural language
  • Batch Processing: Automate repetitive 3D tasks

šŸ¤ Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

šŸ‘¤ Author

Rishi Thakar

šŸ™ Acknowledgments

  • Built using the Model Context Protocol (MCP) specification
  • Powered by Blender's Python API
  • Inspired by the need for accessible 3D content creation
  • Used Exising Blender MCP Repo

This project demonstrates the integration of AI language models with professional 3D software, showcasing the potential for natural language-driven 3D content creation.