What is Blender MCP?
Blender-MCP is a minimalist Minecraft Protocol (MCP) server implementation in Python, integrated with Blender’s 3D engine for visual simulation. It allows developers to prototype and test Minecraft bots without launching a full Minecraft server, offering a lightweight and programmable testing environment.
Whether you’re creating AI agents, debugging pathfinding logic, or simulating in-game actions, Blender-MCP gives you the freedom to do it all within a Pythonic and Blender-powered workflow.
Blender MCP Key Features
Run a minimal MCP server using Python without any dependencies on official Minecraft server binaries.
Perfect for testing Minecraft bots (e.g., using Mineflayer) in a virtual, code-controlled environment.
Leverages Blender’s engine to render and simulate Minecraft-like scenes for visual debugging.
No need to wait for a full Minecraft server to boot, get instant feedback on bot behavior and network interactions.
Great for teaching and learning about game protocols, bot development, and simulation-based AI.
Blender MCP Installation Guide
git clone https://github.com/ahujasid/blender-mcp.git cd blender-mcp pip install -r requirements.txt
Ensure Blender (version 3.x recommended) is installed and accessible. Blender is used to visualize the bot’s interactions.
- Start the MCP server:
python server.py
2. Connect a Minecraft bot (such as Mineflayer) to the local server at localhost on the port displayed by the script.
3. For visualization, open the provided Blender project file or script your own scene and run it in Blender (with socket or scripting).
This setup allows real-time bot interactions with a Minecraft-like environment rendered in Blender.
Mineflayer Example Bot:
const mineflayer = require('mineflayer');
const bot = mineflayer.createBot({
host: 'localhost',
port: 25565,
username: 'test_bot'
});
bot.on('spawn', () => {
bot.chat('Hello from Blender-MCP!');
});
Project Structure:
server.py: Core Minecraft Protocol server logic in Pythonblender/: Blender files and visual scriptstest/: Examples of bot connections and behavior scripts
Blender MCP Use Cases:
- Test and debug Minecraft bot behavior in a minimal setup
- Simulate and visualize pathfinding or AI interaction in 3D
- Use in educational environments to teach networking and scripting
- Prototype Minecraft-related ideas without relying on full servers