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 - 通过一次调用搜索并安装最匹配的文件。
• 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"
      }
    }
  }
}

Agent 工作流示例

当游戏概念不止对应一种指定资源时，可先获取建议：

{
  "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。

为获得更好的匹配结果，如果游戏背景很重要，Agent 应传入适配提示：

• 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。

当 Agent 需要在搜索前了解目录能提供哪些内容时，请使用 browse_catalog_options。它会返回套餐专属的类别、来源名称、精选用途和示例查询，例如 short menu click、cozy farming sprites、hex strategy tiles 和 low poly furniture props。

当提示词描述的是完整游戏或原型时，请使用 recommend_assets_for_game。当前精选套件涵盖田园种植、奇幻 RPG、平台游戏、太空射击、益智/休闲游戏，以及通用原型备用方案。

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。已安装的第三方资源仍遵循其原始许可证，并保留来源元数据。