Poly Pizza MCP

🚀 Poly.Pizza MCP サーバー

Poly.Pizzaの3DモデルをUnityプロジェクトに直接インポートできるMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• モデル検索: キーワードでPoly.Pizzaから3Dモデルを検索します。
• Unityインポート: 検索したモデルをUnityプロジェクトに自動的にインポートします。
• 一括インポート: 複数のモデルを一度にインポートできます。
• キャッシュ: ダウンロードしたモデルをキャッシュして再利用します。
• プレハブ自動生成: インポートしたモデルから自動的にUnityのプレハブを生成します。
• クレジット自動生成: CC - BYライセンスのモデルのクレジットを自動的に記録します。
• Unity UIでAPIキー設定: 環境変数を使用せずに、Unityエディタ内で直接APIキーを入力できます。

📦 インストール

1. Unityパッケージのインストール (パッケージマネージャー)

Unityで Window > Package Manager を開き、以下の手順を実行します。

1. + ボタンをクリックします。
2. Add package from git URL... を選択します。
3. 次のURLを入力します。

https://github.com/HaD0Yun/poly-pizza-mcp.git?path=unity-package

2. MCPサーバーのインストール

git clone https://github.com/HaD0Yun/poly-pizza-mcp.git
cd poly-pizza-mcp
npm install
npm run build

3. APIキーの設定 (Unity UIを使用 - 推奨)

1. Unityで Window > Poly.Pizza MCP または Poly.Pizza > Dashboard メニューをクリックします。
2. Get API Key ボタンをクリックして、poly.pizza/settings/api からAPIキーを取得します。
3. 取得したAPIキーを入力フィールドに貼り付けます。
4. Save API Key ボタンをクリックします。

APIキーは ~/.poly - pizza/config.json に保存され、MCPサーバーが自動的に読み取ります。

3 - 1. APIキーの設定 (環境変数を使用 - 代替案)

環境変数を使用する場合は、以下のコマンドを実行します。

# Windows
set POLY_PIZZA_API_KEY=your-api-key-here

# macOS/Linux
export POLY_PIZZA_API_KEY=your-api-key-here

4. MCPクライアントの設定

Claude Desktopまたは他のMCPクライアントの設定ファイルに以下を追加します。

{
  "mcpServers": {
    "poly-pizza": {
      "command": "npx",
      "args": ["-y", "poly-pizza-mcp"],
      "env": {
        "UNITY_PROJECT_PATH": "/path/to/UnityProject"
      }
    }
  }
}

注意: APIキーがUnityダッシュボードで設定されている場合は、env に含める必要はありません。

💻 使用例

基本的な使用法

利用可能なツール

set_api_key

APIキーの設定と状態の確認

"APIキーの状態を確認して"
→ set_api_key()

"APIキーを設定して"
→ set_api_key(apiKey: "your-api-key")

"APIキーを削除して"
→ set_api_key(clear: true)

search_models

Poly.Pizzaからモデルを検索

"自動車のモデルを探して"
→ search_models(keyword: "car", limit: 10)

import_to_unity

特定のモデルをUnityにインポート

"このモデルをUnityに追加して: 5EGWBMpuXq"
→ import_to_unity(modelId: "5EGWBMpuXq", createPrefab: true)

batch_import

複数のモデルを一度にインポート

"これらのモデルをすべてインポートして"
→ batch_import(modelIds: ["id1", "id2", "id3"])

quick_import

検索後、最初の結果をすぐにインポート

"中世の剣のモデルをすぐに追加して"
→ quick_import(query: "medieval sword")

search_and_batch_import

検索結果全体を一括インポート

"木のモデルを5つ探してすべてインポートして"
→ search_and_batch_import(keyword: "tree", limit: 5)

get_popular

人気のモデルのリストを取得

"最近人気のあるモデルは何ですか？"
→ get_popular(limit: 20)

cache_status

キャッシュの状態を確認し、管理する

"キャッシュの状態を表示して" → cache_status(action: "status")
"キャッシュをクリアして" → cache_status(action: "clear")

📚 ドキュメント

Unityプロジェクトの構造

MCPサーバーがモデルをインポートすると、以下の構造で保存されます。

Assets/
└── PolyPizza/
    ├── Models/           # 3Dモデルファイル (.glb, .fbxなど)
    ├── Prefabs/          # 自動生成されたプレハブ
    ├── CREDITS.txt       # ライセンスのクレジット
    └── .signals/         # MCP ↔ Unity通信に使用 (自動管理)

Unityメニュー

Unityエディタで使用できるメニューは以下の通りです。

• Window > Poly.Pizza MCP: APIキーの設定とダッシュボード
• Poly.Pizza > Dashboard: APIキーの設定と状態の確認
• Poly.Pizza > Refresh Assets: アセットの更新
• Poly.Pizza > Open Models Folder: モデルフォルダを開く
• Poly.Pizza > Open Prefabs Folder: プレハブフォルダを開く
• Poly.Pizza > Create Prefabs from All Models: すべてのモデルからプレハブを生成

ライセンス情報

Poly.Pizzaのモデルは2種類のライセンスで提供されます。

CC - BYライセンスのモデルを使用する場合、CREDITS.txt に自動的にクレジットが記録されます。ゲームをリリースする際には、クレジット画面にこの内容を含めてください。

開発

# 開発モード (watch)
npm run dev

# ビルド
npm run build

# 実行
npm start

問題解決

APIキーが機能しない場合

• Unityで Poly.Pizza > Dashboard を開き、APIキーが保存されていることを確認します。
• https://poly.pizza/settings/api でキーが有効であることを確認します。
• ~/.poly - pizza/config.json ファイルが存在し、APIキーが正しく保存されていることを確認します。

Unityでモデルが表示されない場合

• Unityエディタが開いていることを確認します。
• Assets > Refresh または Poly.Pizza > Refresh Assets を実行します。
• .signals フォルダのファイルが処理されていることを確認します。

キャッシュの問題

• cache_status(action: "clear") でキャッシュを初期化します。

📄 ライセンス

MIT

クレジット

• Poly.Pizza - 無料のローポリ3Dモデル
• 作成者: dook (Zac Lucarelli)