Game Asset MCP

🚀 ゲーム資産管理ツール

このゲーム資産管理ツールは、Node.jsベースのツールで、MCPプロトコルを通じてゲーム用の2Dおよび3D資産を生成することができます。Claudeデスクトップ版などのMCPクライアントと互換性があります。

🚀 クイックスタート

インストール

1. リポジトリをクローンします：

   git clone https://github.com/your-repository.git
   cd game-asset-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. サービスを起動します：

   • デフォルトでは./logs/server.logにログが記録され、資産は./assetsに保存されます。

     node src/index.js
     

   • カスタムディレクトリを指定する場合：

     node src/index.js /path/to/custom/directory
     

✨ 主な機能

コア機能

• 2D資産生成："gokaygokay/Flux-2D-Game-Assets-LoRA"モデルを使用して50ステップで生成します。
• 3D資産画像生成："gokaygokay/Flux-Game-Assets-LoRA-v2"モデルを使用して30ステップで生成します。
• 多モデルサポート：
  • InstantMesh
  • Hunyuan3D - 2
  • Hunyuan3D - 2mini - Turbo

実行時設定

.envファイルを使用して以下のパラメータを設定できます。

HF_TOKEN=あなたのHuggingFaceトークン
MODEL_SPACE=モデルスペース名（例：gokaygokay/Flux）
PORT= SSE転送ポート、デフォルトは3000

💻 使用例

コマンドラインインターフェース

• サービスを起動する：

  node src/index.js
  

• 保存ディレクトリを指定する：

  node src/index.js /path/to/custom/directory
  

設定ファイル

Claudeデスクトップ版の設定ファイルを編集します。

• ** MacOS**：~/Library/Application Support/Claude/claude_desktop_config.json
• ** Windows**：%APPDATA%\Claude\claude_desktop_config.json

以下の内容を追加します。

{
  "mcpServers": {
    "game-asset-generator": {
      "command": "node",
      "args": ["/full/path/to/game-asset-mcp/src/index.js"]
    }
  }
}

Claudeデスクトップ版を再起動すると設定が有効になります。

📚 ドキュメント

ファイル管理

保存場所

資産は./assetsディレクトリに保存され、以下の命名規則に従って整理されます。

2d_asset_generate_2d_asset_<timestamp>_<unique_id>.png

リソースアクセス

MCP URI形式を使用してリソースにアクセスします。

• リソースを列挙する：asset://2d_asset/
• ファイルにアクセスする：asset://2d_asset/filename.png

高度な機能

APIエンドポイント

• 2D資産生成：

  • エンドポイント：POST /generate/2d
  • パラメータ：{ prompt: "あなたの要件を記述" }

• 3D資産生成：

  • エンドポイント：POST /generate/3d
  • パラメータ：{ prompt: "あなたの要件を記述" }

エラー処理

• 401未承認：HuggingFaceトークンが欠落または無効です。
• 500内部エラー：モデル推論に失敗しました。
• 429レート制限：API呼び出し回数の制限を超えました。

セキュリティに関する注意事項

• .envファイルに機密情報を平文で保存しないでください。
• HuggingFaceトークンを定期的に更新してください。
• ファイアウォールを設定して外部アクセスを制限してください。

プロジェクトアーキテクチャ

コアモジュール

• src/index.js：メインサービスのエントリポイント
• src/api/：APIルートの処理
• src/models/：モデルの読み込みと推論
• src/storage/：資産の保存管理

技術選択

• フレームワーク：Express.js
• モデル管理：HuggingFace Inference API
• ログ記録：デフォルトではファイルに出力され、カスタムロガーもサポートしています。

チュートリアル例

例1：2D資産を生成する

curl -X POST http://localhost:3000/generate/2d \
  -H "Content-Type: application/json" \
  -d '{"prompt": "可愛い小猫"}'

例2：3D資産を生成する

curl -X POST http://localhost:3000/generate/3d \
  -H "Content-Type: application/json" \
  -d '{"prompt": "未来都市の全景図"}'

よくある質問

• Q: 生成速度を向上させるにはどうすればいいですか？

• A: より高性能なモデルを使用するか、ネットワーク帯域を最適化してください。

• Q: リソースの保存ディレクトリはどこですか？

• A: デフォルトは./assetsですが、起動パラメータで指定することができます。

• Q: どの3D形式がサポートされていますか？

• A: 現在、obj、gltf、pngなどの一般的な形式がサポートされています。

開発ガイド

モジュール開発

1. 新しい2D生成器を追加する：

   npm run dev 2d
   

2. 新しい3D生成器を追加する：

   npm run dev 3d
   

コントリビューションガイド

• コードを提出する前に、すべてのテストケースを通過していることを確認してください。
• eslintとprettierのコード規約に従ってください。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。詳細はLICENSEファイルを参照してください。