Sandbox
@jasonjgardner/blockbench-mcp-plugin

Blockbench MCP server plugin for agent tools

This repo adds an MCP server to Blockbench so agents can work with Blockbench through tools and prompts. The plugin exposes a local endpoint, with docs for connecting Claude Code and other MCP clients.

423 stars50 forksTypeScriptUpdated 2mo ago
Who it's for

Builders who want an agent to edit or inspect Blockbench projects through MCP.

What it delivers

You can connect an agent to Blockbench instead of copying model steps back and forth by hand.

What it does

MCP server endpoint

Runs a Blockbench MCP server at the configurable `:3000/bb-mcp` endpoint.

Agent connection examples

Shows setup for Claude Code, Claude Desktop, VS Code MCP config, Cline, Ollama, and OpenCode.

Prompt and skill support

Includes prompt files under `prompts/` and a skills-based workflow note for orchestrating tool use.

Plugin UI and settings

Adds UI files under `ui/` for settings, status, and prompt preview dialogs.

Blockbench tool integration

Implements server tools and resources in `server/tools/` and `server/resources/` for Blockbench actions.

How to get it

  1. 1Run
    npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project
  2. 2Run
    claude mcp add blockbench --transport http http://localhost:3000/bb-mcp
  3. 3Run
    uvx ollmcp -u http://localhost:3000/bb-mcp
  4. 4Run
    opencode mcp add

README

Blockbench MCP

https://github.com/user-attachments/assets/ab1b7e63-b6f0-4d5b-85ab-79d328de31db

Plugin Installation

Open the desktop version of Blockbench, go to File > Plugins and click the "Load Plugin from URL" and paste in this URL:

https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js

Model Context Protocol Server

Configure the MCP server under Blockbench settings: Settings > General > MCP Server Port and MCP Server Endpoint

The following examples use the default values of :3000/bb-mcp

Installation

General

npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project

VS Code

.vscode/mcp.json

{
  "servers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "http"
    }
  }
}

Claude Desktop

claude_desktop_config.json (macOS/Linux)

{
  "mcpServers": {
    "blockbench": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    }
  }
}

claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "blockbench": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    }
  }
}

Claude Code

claude mcp add blockbench --transport http http://localhost:3000/bb-mcp

Antigravity

{
  "mcpServers": {
    "blockbench": {
      "serverUrl": "http://localhost:3000/bb-mcp"
    }
  }
}

Cline

Connecting to Blockbench MCP plugin through Cline

cline_mcp_settings.json

{
  "mcpServers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "streamableHttp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ollama

uvx ollmcp -u http://localhost:3000/bb-mcp

Recommended: jonigl/mcp-client-for-ollama

OpenCode

opencode mcp add
Connecting to Blockbench MCP plugin through OpenCode.

Usage

See sample project for prompt examples.

Skills

Use Agent Skills to orchestrate tool usage.

Plugin Development

See CONTRIBUTING.md for detailed instructions on setting up the development environment and how to add new tools, resources, and prompts.

Files in the repo

Repository payload26 top-level entries
  • .agents
  • .github
  • .vscode
  • build
  • docs
  • lib
  • macros
  • prompts
  • server
  • ui
  • .coderabbit.yaml
  • .gitignore
  • about.md
  • AGENTS.md
  • bun.lock
  • CLAUDE.md
  • CONTRIBUTING.md
  • icon.svg
  • index.ts
  • LICENSE
  • llms-install.md
  • llms.txt
  • package.json
  • README.md
  • tsconfig.json
  • types.d.ts

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k