mcpField
B
Blockbench MCP

Blockbench MCP

ローカル
jasonjgardner.github.io開発ツール5853 日前に更新
リポジトリ公式サイト

Blockbench MCP について

Blockbench MCP は、3D モデリングエディター Blockbench に MCP サーバー機能を追加し、デスクトップアプリで開いているモデルを AI アシスタントから操作できるようにします。Blockbench を起動せずに .bbmodel を編集、検証、変換、レンダリングできる stdio の無頭サーバーも含み、モデル制作の自動化を目指す方を想定しています。

主な機能

  1. 01デスクトッププラグインによるローカル HTTP エンドポイント経由のツール公開
  2. 02無頭サーバーによる .bbmodel ファイルの直接編集
  3. 03モデルの検証、変換、レンダリング
  4. 04Agent Skills によるツール呼び出しの編成
  5. 05他のプラグインが MCP ツールを登録できる拡張機能

活用シーン

  1. 01Blockbench 上でのモデリングとテクスチャ作業を AI アシスタントで補助
  2. 02エディターを起動せずに .bbmodel ファイルを検証またはレンダリング
  3. 03同じディレクトリのモデルファイルに対する複数エージェントの並列作業

MCP 対応

このプロジェクトは 2 形態の MCP サーバーです。デスクトッププラグインは HTTP で Blockbench のツールを公開し、無頭サーバーは stdio で動作します。HTTP サーバーは既定でループバックのみを待ち受け、設定で risky_eval ツールを無効にできます。

#blockbench#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "blockbench-mcp-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-add"
      ]
    }
  }
}
起動コマンドnpx -y mcp-add

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmcp-add

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Blockbench MCP

Blockbench MCP Plugin screenshot
デモ動画

https://github.com/user-attachments/assets/c67d0dd8-ee50-40ba-b308-a84a21772901

すべてのシーン、モデル、テクスチャは、エージェントスキルを使用して Blockbench MCP プラグインで作成されています。（Blender でレンダリング）

skills.sh

プラグインのインストール

Blockbench のデスクトップ版を開き、File > Plugins に移動して「Load Plugin from URL」をクリックし、次の URL を貼り付けます。

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

Model Context Protocol サーバー

このリポジトリには、2 つの MCP サーバーの選択肢があります。

ヘッドレス .bbmodel（stdio）

独立した stdio MCP サーバーは、Blockbench を起動せずに .bbmodel ファイルを直接編集、検証、変換、レンダリングします。各エージェントが独自のプロセスを起動できるため、エディターを使い続けながら複数のエージェントを並行して作業させることができます。GitHub から直接実行できます。

npx -y github:jasonjgardner/blockbench-mcp-plugin --root ./models

クライアントの設定、ツール一覧、制限事項については、headless/README.md を参照してください。

Blockbench デスクトッププラグイン（HTTP）

Blockbench の設定で MCP サーバーを設定します。Settings > General > MCP Server Port および MCP Server Endpoint を選択してください。

以下のインストール設定例では、デフォルト値の :3000/bb-mcp を使用しています。

インストール

以下の例では、デスクトッププラグインを HTTP 経由で、ヘッドレスサーバーを stdio 経由で設定します。どちらか一方、または両方のサーバーを使用できます。HTTP では、プラグインをインストールした状態で Blockbench を起動しておく必要があります。stdio では npm を含む Node.js が必要で、独自のサーバープロセスが起動します。

ヘッドレスの例では、/path/to/models をモデルディレクトリの絶対パスに置き換えてください（Windows の場合は C:/Users/you/models など）。--root は必須で、ファイルアクセスをそのディレクトリに制限します。

Windows で npx を直接起動できないクライアントでは、Claude Desktop の例のように "command": "cmd" を指定し、args の先頭に "/c", "npx" を追加してください。

一般 
# Desktop plugin (HTTP)
npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project

# Headless (stdio)
npx mcp-add --name bbmodel --type stdio --command "npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models" --scope project
VS Code

.vscode/mcp.json

{
  "servers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "http"
    },
    "bbmodel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:jasonjgardner/blockbench-mcp-plugin",
        "--root",
        "${input:rootDir}"
      ]
    }
  },
  "inputs": [
    {
      "id": "rootDir",
      "type": "promptString",
      "description": "Root directory for headless Blockbench models",
      "default": "${workspaceFolder}/models"
    }
  ]
}
Claude Desktop

claude_desktop_config.json（macOS/Linux）

{
  "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"]
    }
  }
}

claude_desktop_config.json（Windows）

{
  "mcpServers": {
    "blockbench": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    },
    "bbmodel": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "C:/Users/you/models"]
    }
  }
}
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
Codex 
codex plugin marketplace add jasonjgardner/blockbench-mcp-project --ref codex
codex plugin add blockbench-mcp@blockbench-mcp-project

または、サーバーを直接登録します。

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

# Headless (stdio)
codex mcp add bbmodel -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models
Antigravity 
{
  "mcpServers": {
    "blockbench": {
      "serverUrl": "http://localhost:3000/bb-mcp"
    },
    "bbmodel": {
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
    }
  }
}
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": []
    },
    "bbmodel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Ollama 
# Desktop plugin (HTTP)
uvx ollmcp -u http://localhost:3000/bb-mcp

# Headless (stdio): register, then start the client
uvx ollmcp mcp add bbmodel -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models
uvx ollmcp

推奨：jonigl/mcp-client-for-ollama

OpenCode 
opencode mcp add

デスクトップ HTTP URL にはリモートサーバーを、ヘッドレスコマンドにはローカルサーバーを選択してください。opencode.json で両方を設定することもできます。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "blockbench": {
      "type": "remote",
      "url": "http://localhost:3000/bb-mcp",
      "enabled": true
    },
    "bbmodel": {
      "type": "local",
      "command": ["npx", "-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"],
      "enabled": true
    }
  }
}

ローカルサーバーとリモートサーバーの設定については、OpenCode MCP configuration reference を参照してください。

Connecting to Blockbench MCP plugin through OpenCode.

使い方

プロンプトの例については、サンプルプロジェクトを参照してください。

スキル

エージェントスキルを使用して、ツールの使用をオーケストレーションします。

別のプラグインからの拡張

他の Blockbench プラグインは、このプラグインをバンドルしたりインポートしたりせずに、グローバルな MCP_QUEUE を通じて独自の MCP ツールを登録できます。API と例については、docs/plugin.md を参照してください。

メモ

公式 Blockbench プラグインリポジトリのプラグインでは AI 機能の使用が許可されていないため、MCP ツールを登録するプラグインは別の方法で配布する必要があります。

プラグイン開発

開発環境のセットアップ方法、新しいツール、リソース、プロンプトの追加方法について詳しくは、CONTRIBUTING.md を参照してください。

セキュリティ

デスクトッププラグインの HTTP サーバーは、デフォルトではこのコンピューター上（127.0.0.1 と ::1）でのみリッスンするため、クライアントが localhost を IPv4 または IPv6 のどちらに解決しても、http://localhost:3000/bb-mcp を使用できます。ループバック以外の Origin または Host ヘッダーを含むリクエストは 403 Forbidden となり、DNS リバインディング攻撃を含む Web ページがブラウザーを通じて Blockbench を操作するのを防ぎます。

他のコンピューターからの接続を許可するには（ミラーネットワークが設定されていない WSL2 内のクライアント、VM、別のマシンなど）、Settings > General > MCP Server Host を 0.0.0.0 または :: に設定し、プラグインを再読み込みします。このモードでは、他のコンピューターはサーバーにアドレスで接続するため、Host ヘッダーはチェックされなくなりますが、ループバック以外の Origin ヘッダーを含むリクエストは引き続き拒否されます。サーバーには認証がありません。ポートに接続できるユーザーは、risky_eval を含むすべてのツールを呼び出せます。信頼できるネットワークでのみ実行し、ファイアウォールのルールを厳格に保ってください。

risky_eval は、クライアントが送信したあらゆる JavaScript を実行します。無効にするには、Settings > General > Enable risky_eval のチェックを外します。接続中のクライアントにはこのツールが表示されなくなり、呼び出しも拒否されます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。