Blockbench MCP Plugin

Blockbench MCP Plugin とは？

Blockbench MCP は、Blockbench デスクトップアプリ内で Model Context Protocol サーバーを動かすオープンソースのプラグインです。Claude Code、VS Code、Cline などの AI エージェントが、ツール呼び出しを通じてローポリ 3D モデルの作成、テクスチャ作成、アニメーション制作を行えるようになります。

jasonjgardner によるこのリポジトリはコミュニティプロジェクトで、Blockbench 本体の一部ではありません。2 つのサーバーが含まれています。起動中のエディターを HTTP で操作するデスクトッププラグインと、Blockbench を開かずに .bbmodel ファイルの編集・検証・変換・レンダリングを行うヘッドレスの stdio サーバーです。

Blockbench MCP Plugin の使い方

前提条件：プラグインサーバーには Blockbench デスクトップ版、ヘッドレスサーバーには Node.js と npm が必要です。API キーは不要です。

1. Blockbench で File > Plugins を開き、Load Plugin from URL をクリックして https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js を貼り付けます。
2. Settings > General > MCP Server Port と MCP Server Endpoint を確認します。以下の例ではデフォルトの http://localhost:3000/bb-mcp を使用しています。
3. Blockbench を開いたまま、クライアントを接続します。

ヘッドレスの Blockbench MCP サーバーを使う場合は、/path/to/models を絶対パスに置き換えてください。--root は必須で、ファイルアクセスをそのディレクトリ内に制限します。

Claude Code

# Desktop plugin (HTTP)
claude mcp add blockbench --transport http http://localhost:3000/bb-mcp

# Headless (stdio)
claude mcp add bbmodel --transport stdio -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models

Claude Desktop

Claude Desktop は mcp-remote 経由で HTTP プラグインに接続します。claude_desktop_config.json に次を追加します。

{
  "mcpServers": {
    "blockbench": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    },
    "bbmodel": {
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
    }
  }
}

Windows では "command": "cmd" を使い、args の先頭に "/c", "npx" を追加します。

VS Code

.vscode/mcp.json に次を記述します。

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

Codex

codex mcp add blockbench --url http://localhost:3000/bb-mcp

README には Cline、Antigravity、OpenCode、Ollama（uvx ollmcp -u http://localhost:3000/bb-mcp）の設定方法も記載されています。

Blockbench MCP Plugin の主な機能

• Blockbench デスクトップアプリに組み込まれた MCP サーバー。Streamable HTTP で提供され、ポートとエンドポイントは設定可能
• .bbmodel ファイル用の独立したヘッドレス stdio サーバー。エディターを使い続けながら、複数のエージェントが並行して作業可能
• キューブ、メッシュ、テクスチャ、PBR マテリアル、UV、アニメーション、カメラ、エクスポート、プロジェクト設定のためのツール
• ヘッドレスでのジオメトリとアニメーションの検証、Bedrock .geo.json、Java ブロック/アイテムモデル、Mod 用エンティティクラスへのエクスポート
• デフォルトはローカル限定：127.0.0.1/::1 で待ち受け、ループバック以外の Origin や Host ヘッダーを拒否
• 他の Blockbench プラグインがグローバルな MCP_QUEUE を通じて独自の MCP ツールを登録可能
• 付属の Agent Skills と、プロンプト例を含むサンプルプロジェクト

Blockbench MCP Plugin のツール

デスクトッププラグインのツールは、エディターの領域ごとにまとめられています。

• モデリング： place_cube、modify_cube、place_mesh、extrude_mesh、subdivide_mesh、create_sphere、create_cylinder、loop_cut_mesh、knife_tool でジオメトリを作成・変形します。
• アウトライナーと要素： add_group、list_outline、duplicate_element、rename_element、remove_element でモデルを整理します。
• テクスチャとマテリアル： create_texture、apply_texture、list_textures、create_pbr_material、import_texture_set がテクスチャと PBR チャンネルを扱います。
• カメラとスクリーンショット： set_camera_angle、capture_screenshot、capture_app_screenshot で、エージェントが自分の作業結果を確認できます。
• プロジェクトとエクスポート： create_project、get_project_info、list_export_formats、export_model。
• スクリプト： risky_eval は Blockbench 内で任意の JavaScript を実行します。設定で無効化できます。

ヘッドレスサーバーは bbmodel_create、bbmodel_edit、bbmodel_validate、bbmodel_render、bbmodel_export_bedrock_geometry などの bbmodel_* ツールに加え、デスクトップアプリを起動する blockbench_launch を提供します。

Blockbench MCP Plugin のユースケース

• 説明文からゲームアセットを素早く作成：「Create a low-poly treasure chest with a hinged lid and a 32x32 texture.」
• Minecraft 風のモブやアイテムを作り、Bedrock ジオメトリや Java ブロック/アイテムモデルとしてエクスポート。
• リギングとアニメーション：「Add a walk cycle to this model and check that no limbs detach.」
• ヘッドレスサーバーで、フォルダー内の .bbmodel ファイルを一括チェックし、浮いたパーツや崩れた対称性を検出。
• エージェントにビューポートのスクリーンショットを撮らせ、見た目が整うまでプロポーションを調整。
• PBR テクスチャセットを生成し、既存モデルにチャンネルを割り当てる。

Blockbench MCP Plugin と代替ツールの比較

ローポリエディターではなく本格的な 3D ソフトで作業するなら、Blender MCP で同様に Blender をエージェントから操作できます。ゲームエンジン側の作業には、Unity MCP や Godot MCP がそれぞれのエディターにエージェントを接続します。Minecraft 風、ボクセル風、Bedrock/Java 向けのコンテンツには、ツールとエクスポーターが Blockbench 独自の形式に沿っている Blockbench MCP が適しています。

Blockbench MCP Plugin のトラブルシューティング

• クライアントが接続できない： Blockbench が起動してプラグインが読み込まれている必要があり、URL は Settings > General のポートとエンドポイントに一致している必要があります。デフォルトのパスは /bb-mcp です。
• クライアントが WSL2、VM、別のマシンにある： サーバーはデフォルトでループバックのみで待ち受けます。MCP Server Host を 0.0.0.0 または :: に設定してプラグインを再読み込みしてください。ただしサーバーには認証がないため、信頼できるネットワークでのみ行ってください。
• Windows クライアントが npx を起動できない： "command": "cmd" を使い、引数の前に "/c", "npx" を付けます。
• ヘッドレスでの編集が Blockbench に反映されない： Blockbench はディスク上で変更されたファイルを再読み込みしません。モデルを開き直し、同じファイルを両方で同時に編集しないでください。
• ヘッドレスのレンダリングが失敗する： レンダリングツールには Node 23.6 以降と GPU が必要です。それ以外のヘッドレスツールは不要です。