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 サーバーを追加するには、次のようにします。
- Settings > Developer > Edit Config [設定 > 開発者 > 設定を編集] に進み、claude_desktop_config の JSON ファイルに次のコードを追加します
"mcpServers": {
"cosmos": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:30305/mcp"]
}
},
ファイルにすでに mcpServers セクションがある場合は、そのセクションに cosmos のエントリーだけを追加します。
npx コマンドを使うには、Node.js がインストールされている必要があります。
- そのあと、Claude を再起動します
MCP のワークフロー例
次の例では、アシスタントがプロンプトだけを使って、V-Ray と Cosmos で Blender の空の部屋に家具を配置します。このセッションで、アシスタントは次のことを行います。
- フレンチドアなどの建築要素を追加する
- 床にオークのマテリアルを適用するなど、Cosmos のマテリアルを適用する
- コーヒーコーナー用の関連アセット一式など、アセットを検索、ダウンロード、インポートして配置する
- レイアウトに合うようにアセットを配置し直す
- アセットを参照画像に合わせる
- シーンをレンダリングする