home / mcp / blockbench mcp server
Provides a Blockbench MCP server that connects to MCP clients via HTTP and local runtime configurations.
Configuration
View docs{
"mcpServers": {
"jasonjgardner-blockbench-mcp-plugin": {
"url": "http://localhost:3000/bb-mcp"
}
}
}You can connect Blockbench to an MCP client via a dedicated MCP server that runs alongside Blockbench. This setup lets you exchange commands and data between your 3D models and MCP-enabled tools, enabling streamlined prompts, tools, and workflows for model-related tasks.
Use the Blockbench MCP server to route requests from your MCP client to the local Blockbench plugin. Start Blockbench, ensure the MCP server is reachable at the configured endpoint (default port 3000 with the /bb-mcp path), and configure your MCP client to point at http://localhost:3000/bb-mcp. You can connect via either HTTP to the running server or via a local runtime command that talks to that HTTP endpoint. Your client will then be able to issue prompts, load tools, and receive results that integrate directly with your Blockbench project.
Prerequisites: ensure Blockbench is installed on your machine. You may also need Node.js/npm if you plan to use local console configurations.
Install the MCP plugin by loading it from the URL inside Blockbench. This enables the Blockbench MCP integration and makes the /bb-mcp endpoint available when you run the server.
Configure the MCP server in Blockbench settings to expose a port and endpoint. By default, the server URL will be http://localhost:3000/bb-mcp.
Then set up client configurations to connect to the server. Use one of the following examples depending on your environment.
{
"servers": {
"blockbench": {
"url": "http://localhost:3000/bb-mcp",
"type": "http"
}
}
}{
"mcpServers": {
"blockbench": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:3000/bb-mcp"
]
}
}
}The first snippet is for VS Code users who want to point the MCP client to the local HTTP server. The second snippet is for Claude Desktop users who run the MCP client through a local npx command. If you make changes to the server URL or port, adjust the configurations accordingly.
If you are developing or extending the Blockbench MCP integration, you can follow project guidelines for setting up the development environment and adding new tools, resources, and prompts to your MCP configuration.