Blockbench MCP Plugin

Blockbench MCP Plugin

Blockbench MCP is a Model Context Protocol server enabling AI agents to interact with Blockbench's JavaScript API.

21
Stars
5
Forks
3
Releases

Overview

Blockbench MCP is a Model Context Protocol (MCP) server that enables AI agents to connect to Blockbench's JavaScript API to create and edit 3D models or pixel art textures. It is configured via Blockbench's Settings under General where you set the MCP Server Port and MCP Server Endpoint; the examples assume the default endpoint at /bb-mcp. Installation is done by loading the provided mcp.js plugin via the Blockbench plugin URL. The README provides concrete client configurations for common development environments: for VS Code, a .vscode/mcp.json file pointing to http://localhost:3000/bb-mcp with type http; for Claude Desktop, a claude_desktop_config.json entry that runs mcp-remote with the same URL. A sample project is linked for prompt examples, illustrating how to interact with the MCP server. For developers, CONTRIBUTING.md covers how to set up the development environment and how to add new tools, resources, and prompts. The default setup uses port 3000, and the endpoint can be adjusted as needed to integrate AI-driven workflows within Blockbench.

Details

Owner
jasonjgardner
Language
TypeScript
License
GNU General Public License v3.0
Updated
2025-12-07

Features

MCP Server for Blockbench

Implements the Model Context Protocol server that allows AI agents to interact with Blockbench via its JavaScript API to create and edit content.

Plugin-based installation

Install by loading the MCP plugin from URL (mcp.js) directly in Blockbench.

Configurable port and endpoint

Configure MCP Server Port and MCP Server Endpoint in Blockbench settings with a default path of /bb-mcp.

Default endpoint in examples

Demonstrates usage with the default :3000/bb-mcp endpoint for client configuration.

VS Code integration example

Provides a .vscode/mcp.json snippet showing how to connect to the MCP server.

Claude Desktop integration example

Provides a claude_desktop_config.json snippet to launch mcp-remote against the MCP server.

Usage reference and sample project

Links to a sample project with prompts illustrating AI interactions with Blockbench.

Developer guide

Points to CONTRIBUTING.md for setting up the development environment and adding new tools, resources, and prompts.

Audience

Blockbench usersConnect AI agents to Blockbench's JavaScript API to create and edit 3D models and textures.
Plugin developersSet up and customize MCP servers for AI-driven Blockbench workflows and integrations.

Tags

BlockbenchMCPModel Context ProtocolAI agentsJavaScript API3D modelingpixel art texturespluginVS CodeClaude Desktopprompt examplesdevelopment