What is Blender Bonsai Bim Mcp

blender-bonsai-bim-mcp is a Node.js implementation of the Model Context Protocol (MCP) server designed for integrating Blender with Bonsai BIM. It facilitates interaction between Claude AI and Blender for creating and managing Building Information Modeling (BIM) elements and floor plans.

Use cases

Use cases include generating walls and rooms through natural language commands, creating detailed floor plans, and adjusting material properties of BIM elements directly via AI interactions.

How to use

To use blender-bonsai-bim-mcp, clone the repository, install the necessary dependencies using ‘npm install’, and build the project with ‘npm run build’. Ensure the Blender Bonsai BIM addon is running on port 9876, and configure Claude for Desktop to connect to this MCP server by updating the ‘claude_desktop_config.json’ file.

Key features

Key features include the ability to create BIM elements from natural language prompts, generate floor plans based on descriptions, modify properties of BIM elements, and enable socket-based communication with Blender.

Where to use

blender-bonsai-bim-mcp is primarily used in architecture, engineering, and construction industries where Building Information Modeling (BIM) is essential for project design and management.

Blender Bonsai BIM MCP

A Node.js implementation of the Model Context Protocol (MCP) server for Blender Bonsai BIM integration. This server allows Claude AI to interact with Blender for creating and manipulating BIM elements and floor plans.

Prerequisites

• Node.js 18 or newer
• Blender 3.0 or newer
• BlenderBIM Addon installed and enabled
• Claude for Desktop

Installation

1. Clone this repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

1. Make sure the Blender Bonsai BIM addon is running and listening on port 9876
2. Configure Claude for Desktop to use this MCP server by adding the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "blender-bonsai-bim": {
      "command": "node",
      "args": [
        "build/index.js"
      ]
    }
  }
}

Features

• Create BIM elements from natural language prompts
• Generate floor plans from natural language descriptions
• Set and modify properties for BIM elements
• Socket-based communication with Blender

Usage

Once configured, you can use Claude to interact with Blender through natural language commands like:

• “Create a wall 5 meters long and 3 meters high”
• “Generate a floor plan with a living room and two bedrooms”
• “Set the material of the wall to concrete”

Development

The project is written in TypeScript and uses:

• @modelcontextprotocol/sdk for MCP server implementation
• zod for runtime type validation
• Node.js net module for socket communication with Blender

License

MIT