Asset Hub Mcp

AssetHub MCP

AssetHub MCP は、Asset Hub MCP の公開 MCP クライアントです。Codex、Claude Code、Cursor などの MCP クライアントから、ホストされたゲームアセットのカタログを検索し、指定したファイルをプロジェクトにインストールして、帰属表示メタデータを記述できます。

このリポジトリには、インストール可能な MCP クライアントのみが含まれています。ホスト型 API、課金、アカウントシステム、有料カタログのインフラストラクチャは、非公開のサービスコードです。

ツール

• search_assets - 種類、クエリ、タグ、ライセンス、形式、ソース、ゲームとの適合性に関するヒントで検索します。
• search_asset_files - click_001.ogg などの特定のファイルをアーカイブ内から検索し、ゲームのジャンル、ムード、スタイル、用途、除外するコンセプトに関するヒントで順位付けします。
• recommend_assets_for_game - ゲームのアイデアを、カテゴリ、適合理由、特定のファイル候補、保存先ディレクトリ、インストール呼び出しを含む、厳選されたスターターキットに変換します。
• download_asset - 許可されたアセットパックをダウンロードして、指定したディレクトリに展開します。
• install_asset_files - ファイル検索で返された特定のファイルをインストールします。
• install_best_asset - 1 回の呼び出しで、最適なファイルを検索してインストールします。
• get_attribution - 選択したアセットの帰属表示テキストと JSON メタデータを生成します。
• browse_catalog_options - 現在のプランで利用可能なカテゴリ、ソース、用途、クエリの例を表示します。
• list_licenses - 対応するライセンスポリシーと安全なデフォルト設定を表示します。

インストール

npx -y @tcamp404/assethub-mcp@latest ASSET_HUB_API_KEY=ah_your_customer_key

ASSET_HUB_API_BASE_URL のデフォルト値は https://assethubmcp.com です。

MCP クライアントの設定

{
  "mcpServers": {
    "asset-hub": {
      "command": "npx",
      "args": ["-y", "@tcamp404/assethub-mcp@latest"],
      "env": {
        "ASSET_HUB_API_KEY": "ah_your_customer_key",
        "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
      }
    }
  }
}

エージェントのフロー例

ゲームのコンセプトが特定のアセットだけでは表せない場合は、レコメンデーションから始めます。

{
  "tool": "recommend_assets_for_game",
  "arguments": {
    "gameDescription": "A cozy farming game with crops, animals, shop menus, and gentle reward sounds.",
    "gameGenre": "cozy farming",
    "mood": "soft friendly",
    "visualStyle": "pixel 2d",
    "avoid": ["horror", "weapon", "sci-fi"],
    "maxCategories": 5
  }
}

レスポンスには、選択されたキット、推奨カテゴリ、最適なパック／ファイル、保存先ディレクトリ、およびすぐに実行できる install_best_asset の引数が含まれます。

{
  "tool": "install_best_asset",
  "arguments": {
    "type": "sound",
    "query": "short menu click UI blip",
    "gameGenre": "cozy farming",
    "mood": "soft friendly",
    "intendedUse": "menu confirm",
    "avoid": ["horror", "weapon", "loud"],
    "targetDir": "public/audio/ui",
    "projectRoot": "/path/to/game",
    "includeExtensions": [".wav", ".ogg"],
    "maxFiles": 3
  }
}

特定のファイルをインストールする場合：

{
  "tool": "search_asset_files",
  "arguments": {
    "type": "sound",
    "query": "short menu click",
    "gameContext": "cozy farming game main menu",
    "intendedUse": "short menu confirm",
    "formats": [".ogg"],
    "limit": 3
  }
}

その後、返された asset.id と file.entryPath の値を install_asset_files に渡します。

より適切な結果を得るには、ゲームのコンテキストが重要な場合、エージェントは適合性に関するヒントを渡す必要があります。

• gameContext：ゲーム、レベル、シーン、またはメカニクスの簡潔な説明。
• gameGenre：例：cozy farming、fantasy RPG、sci-fi shooter、puzzle、racing。
• mood：例：cute、tense、dark、friendly、retro、futuristic。
• visualStyle：例：pixel、low-poly、cartoon、monochrome、hand-drawn。
• intendedUse：例：background loop、menu confirm、NPC、enemy、inventory icon、terrain tile。
• prefer と avoid：加点または減点する追加のコンセプト。

ホスト型 API の契約

ホスト型 API は非公開ですが、クライアントは簡潔なドキュメント付き JSON 契約を使用します。

• POST /v1/search
• POST /v1/files/search
• GET /v1/assets/:assetId
• GET /v1/catalog/options
• GET /v1/catalog/kits
• POST /v1/recommendations/game
• GET /v1/licenses

ホスト型リクエストでは、すべて次を使用します。

Authorization: Bearer ah_your_customer_key

現在のプランでは利用できる範囲が限られている場合、search_assets はアップグレードが必要な該当結果を返すことがあります。

{
  "results": [],
  "lockedResults": [
    {
      "id": "kenney-music-jingles",
      "title": "Kenney Music Jingles",
      "accessible": false,
      "upgradeRequired": "indie",
      "minimumPlan": "indie"
    }
  ],
  "plan": "free"
}

アクセス可能なファイルの検索結果が見つからない場合、search_asset_files はプランの上限を超えるパックについて lockedAssetResults を返すことがあります。

検索前にカタログで回答できる内容をエージェントが把握する必要がある場合は、browse_catalog_options を使用します。プランに応じたカテゴリ、ソース名、厳選された用途、short menu click、cozy farming sprites、hex strategy tiles、low poly furniture props などのクエリ例が返されます。

プロンプトがゲーム全体またはプロトタイプに関するものの場合は、recommend_assets_for_game を使用します。現在、厳選されたキットには、cozy farming、fantasy RPG、platformer、space shooter、puzzle/casual、および汎用のプロトタイプ用キットが含まれています。

Claude Code

claude mcp add --transport stdio asset-hub --scope user \
  --env ASSET_HUB_API_KEY=ah_your_customer_key \
  --env ASSET_HUB_API_BASE_URL=https://assethubmcp.com \
  -- npx -y @tcamp404/assethub-mcp@latest

開発

npm install
npm run build
npm test

ライセンス

MIT。インストールしたサードパーティ製アセットには、元のライセンスとソースメタデータが適用されます。