====== Cosmos MCP Server ======

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

===== 概要 =====

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

  * 名前、キーワード、カテゴリ、説明、参照画像でアセットを検索する
  * アセットをダウンロードする
  * ダウンロードしたアセットをホストアプリケーションにインポートする

<alert type="info">
現在、Cosmos MCP は V-Ray と Corona に対応しています。
</alert>

===== MCP のセットアップ =====

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

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


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

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

  * **Settings > Developer > Edit Config [設定 > 開発者 > 設定を編集]** に進み、//claude_desktop_config// の JSON ファイルに次のコードを追加します

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

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

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

  * そのあと、Claude を再起動します

===== MCP のワークフロー例 =====

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

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

<alert type="info">
Cosmos アセットの多くは、V-Ray プロキシとしてインポートされます。ビューポートには簡略化されたプレビューが表示され、完全なジオメトリとマテリアルはレンダリング時にだけ現れます。結果を確認するには、アシスタントに V-Ray でのレンダリングを頼んでください。
</alert>
</WRAP>
<WRAP half column>
{{youtube>M_GnubZg2V4?large}}
</WRAP>
</WRAP>