Gemini CLIを使用したBlender MCPの設定

AI駆動の3Dモデリングのために、Google Gemini CLIでBlender MCPをセットアップするための完全なステップバイステップガイド

Gemini CLI Blender MCP設定

はじめに

Gemini CLIは、ターミナルからGoogleのGemini AIモデルと直接通信できる強力なコマンドラインインターフェースです。Blender MCPをGemini CLIと統合することで、AIの機能を活用してBlenderの3Dモデリングワークフローを強化できます。

このガイドでは、Node.jsのインストールからMCPサービスの検証まで、セットアップの全プロセスをステップバイステップで案内します。

前提条件

  • Windows、macOS、またはLinuxシステム
  • ソフトウェアをインストールするための管理者権限
  • Geminiアクセス権限を持つGoogleアカウント
  • コマンドラインインターフェースの基本的な理解
  • システムにBlenderがインストール済み(オプションですが推奨)

ステップ1:Node.jsのインストール

Gemini CLIとBlender MCPサーバーの実行にはNode.jsが必要です。以下の手順に従ってインストールしてください:

Windows の場合:

  1. nodejs.org にアクセス
  2. LTS(長期サポート)バージョンをダウンロード
  3. インストーラーを実行してインストールウィザードに従う
  4. すべてのデフォルトオプションを受け入れ(npmとPATH設定を含む)
  5. 「完了」をクリックしてインストール完了

macOS の場合:

  1. Homebrew を使用: brew install node
  2. または nodejs.org からダウンロードしてインストーラーを実行

Linux の場合:

パッケージマネージャーを使用します。例えば、Ubuntu/Debianの場合:

sudo apt update
sudo apt install nodejs npm

Node.jsインストールの確認

ターミナルまたはコマンドプロンプトを開いて以下を実行:

node --version
npm --version

Node.jsが正しくインストールされていれば、両方のコマンドがバージョン番号を返します。

ステップ2:Gemini CLIのダウンロードとインストール

Node.jsがインストールされたので、Gemini CLIをダウンロードしてセットアップできます:

インストール手順

  1. ターミナルまたはコマンドプロンプトを開く
  2. Gemini CLIプロジェクトを保存するディレクトリに移動するか作成します(gmcpと呼びます)
  3. ディレクトリを作成:
    mkdir gmcp
    cd gmcp
  4. npmを使用してGemini CLIをダウンロード:
    npm install -g @google/generative-ai-cli
  5. または、npxを使用してグローバルインストールなしで直接実行:
    npx @google/generative-ai-cli

ステップ3:Blender MCPサービスの設定

MCP(Model Context Protocol)サービス設定は、Blender MCPをGemini CLIに接続する重要なステップです。

設定ファイルの検索

Gemini CLIは設定をsettingsファイルに保存します。その場所は:

D:\seocode\tmp\gmcp\.gemini\settings.json

設定の追加

好みのテキストエディター(Visual Studio Code、Notepad++、またはNotepodなど)で settings.json ファイルを開きます。

以下の設定を追加または更新してBlender MCPサービスを有効にします:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

設定の説明

  • mcpServers:すべてのMCPサービス定義を含むオブジェクト
  • blender:MCPサービスの名前(Gemini CLIで識別するために使用)
  • command:実行するコマンド(uvxはPythonのパッケージランナー)
  • args:コマンドに渡される引数(blender-mcpはBlender MCPパッケージ)

設定を保存

設定を追加した後、ファイルを保存します。JSONが正しくフォーマットされており、末尾のコンマや構文エラーがないことを確認してください。

ステップ4:Gemini CLIの終了とログイン

新しいMCPサービス設定を適用するには、Gemini CLIを再起動する必要があります:

Gemini CLIの終了

Gemini CLIが実行されている場合、以下を入力して終了します:

exit

再度ログイン

ターミナルでGemini CLIを再起動します:

npx @google/generative-ai-cli

または、グローバルにインストールした場合:

gemini-cli

ステップ5:MCPサービス設定の検証

Gemini CLIに再度ログインしたら、Blender MCPサービスが正しく構成およびアクセス可能であることを確認してください:

サービスステータスの確認

Gemini CLIで、MCPサービスが読み込まれたことを示すメッセージが表示されるはずです。以下のようなメッセージを探してください:

[INFO] Loading MCP services...
[INFO] Blender MCP service loaded successfully
[INFO] Available tools: blender_create_object, blender_modify_object, ...

統合のテスト

Blender MCPサービスを使用する簡単なコマンドを試してください。例えば:

Blenderでキューブを作成する

BlenderがMCPプラグインとともに実行されている場合、BlenderシーンにキューブがMCPプロトコルを通じてコマンドを送信して表示されるはずです。

トラブルシューティング

問題:Settings.jsonが見つからない

解決策:プロジェクトディレクトリ内に .gemini フォルダーを手動で作成し、上記で提供された設定を使用して settings.json ファイルを作成してください。

問題:「uvxコマンドが見つかりません」

解決策:必要なPythonツールパッケージをインストールします:

pip install uv

問題:MCPサービスが読み込まれない

解決策:以下を確認してください:

  • settings.jsonのJSON構文が正しいことを確認(必要に応じてJSON検証機を使用)
  • ファイルパスが正しいことを確認:D:\seocode\tmp\gmcp\.gemini\settings.json
  • Blender MCPがインストールされていることを確認:uvx blender-mcp --version
  • 詳細なエラーメッセージについてGemini CLIログを確認

問題:Blenderがコマンドに応答しない

解決策:以下を確認してください:

  • BlenderがMCPプラグインとともに実行されていることを確認
  • MCPプラグインがBlender設定で有効になっていることを確認
  • Gemini CLIとBlenderが正しいネットワークポートで接続されていることを確認

次のステップ

これでBlender MCPをGemini CLIで構成したので、次のことができます:

  • 自然言語プロンプトを使用して複雑な3Dシーンを作成
  • AIアシスタンスでオブジェクトとマテリアルを変更
  • 繰り返しの3Dモデリングタスクを自動化
  • GeminiのAI機能とBlenderの強力な3Dツールを組み合わせる
  • カスタムスクリプティングと自動化のための高度なMCP機能を探索

Blender MCPの使用に関する詳細については、公式GitHubリポジトリにアクセスしてください。

まとめ

Gemini CLIを使用したBlender MCPのセットアップは、AIがサポートする3Dモデリングの可能性を無限に広げます。設定プロセスには複数のステップが関わりますが、このガイドに従えば、短時間で立ち上げて実行できるはずです。成功の鍵は、設定ファイルが正しくフォーマットされ、すべてのコンポーネントが正しくインストールされていることを確認することです。

問題が発生したり質問があれば、トラブルシューティングセクションを参照するか、Blender MCPドキュメントをご覧ください。