目次

Cosmos MCP Server

このページでは、Cosmos MCP サーバーの概要、セットアップ方法、AI アシスタントと組み合わせて Cosmos アセットを検索、ダウンロード、インポートする方法を説明します。

概要

Cosmos MCP は、Cosmos を Claude や ChatGPT などの AI アシスタントやエージェントに接続します。接続すると、アシスタントが Cosmos から 3D アセットを見つけてシーンに取り込むので、ライブラリを手作業でブラウズする必要がありません。接続したアシスタントは、次のことを行います。

MCP のセットアップ

Cosmos MCP に、複雑な手作業のセットアップは必要ありません。Cosmos の最新バージョンをインストールし、AI アシスタント(Claude、ChatGPT など)に、Cosmos MCP サーバーをグローバルに設定するよう頼みます。たとえば、次のように伝えます。

Cosmos MCP サーバーをグローバルに設定してください。HTTP エンドポイントは %%http://localhost:30305/mcp です。

設定はアシスタントが行い、ほかに対応が必要な設定があれば知らせてくれます。

アシスタントによっては、サーバーを設定ファイルに手作業で追加する必要があります。たとえば、Claude デスクトップアプリに Cosmos MCP サーバーを追加するには、次のようにします。

"mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:30305/mcp"]
    }
 },

ファイルにすでに mcpServers セクションがある場合は、そのセクションに cosmos のエントリーだけを追加します。

npx コマンドを使うには、Node.js がインストールされている必要があります。

MCP のワークフロー例

次の例では、アシスタントがプロンプトだけを使って、V-Ray と Cosmos で Blender の空の部屋に家具を配置します。このセッションで、アシスタントは次のことを行います。

  • フレンチドアなどの建築要素を追加する
  • 床にオークのマテリアルを適用するなど、Cosmos のマテリアルを適用する
  • コーヒーコーナー用の関連アセット一式など、アセットを検索、ダウンロード、インポートして配置する
  • レイアウトに合うようにアセットを配置し直す
  • アセットを参照画像に合わせる
  • シーンをレンダリングする