AssetBundleMCP 0.1.3

AssetBundleMCP

日本語

AssetBundleMCP is an MCP (Model-Context-Protocol) server for easily and efficiently analyzing Unity AssetBundles through conversations with AI assistants (such as gemini-cli).

With this tool, developers and QA engineers can quickly obtain information such as a list of assets or texture details included in an AssetBundle simply by asking questions in natural language.

Main Features

• Interactive AssetBundle Analysis: Analyze AssetBundles just by talking to your AI assistant.
• Easy Installation: Provided as a NuGet package, so you can easily introduce it by adding it to your configuration file.
• Flexible Data Access: You can also write SQL queries directly to the AI and freely extract information from the database-formatted analysis results.

Prerequisites

• .NET 9.0 SDK or later

Installation & Setup

If .NET 10 is installed (Recommended)

For .NET 10 preview6 or earlier (Not recommended)

1. Clone the repository:
   Clone with submodules using the --recurse-submodules option.

   git clone --recurse-submodules https://github.com/hanachiru/AssetBundleMCP.git
   cd AssetBundleMCP
   

2. Build the project:

   dotnet build -c Release
   

3. Configure the MCP server:
   Create a configuration file in your project root according to your IDE.

   • For Visual Studio Code: .vscode/mcp.json
   • For Visual Studio: .mcp.json

   {
     "servers": {
       "AssetBundleMCP": {
         "type": "stdio",
         "command": "dnx",
         "args": [
           "AssetBundleMCP",
           "--version",
           "0.1.2",
           "--yes"
         ]
       }
     }
   }
   

   • For Gemini Cli: .gemini/settings.json

   {
     "mcpServers": {
       "AssetBundleMCP": {
         "command": "dnx",
         "args": [
           "AssetBundleMCP",
           "--version",
           "0.1.2",
           "--yes"
         ]
       }
     }
   }
   

Usage

1. Load AssetBundle:
   Open Copilot Chat in your IDE, specify the directory path containing the AssetBundle you want to analyze, and instruct it to load.

   @workspace /loadAssetBundle C:/path/to/your/assetbundles

   The tool will analyze the AssetBundle and save the results to a temporary database file.

2. Retrieve Information:
   Once loading is complete, you can ask various questions.

   • Get a list of assets:

     @workspace /listAssets

   • Get a list of textures:

     @workspace /listTextures

   • Find potentially duplicated assets:

     @workspace /listPotentialDuplicates

   • Execute a direct SQL query:

     @workspace /executeSqlQuery SELECT * FROM assets WHERE size > 100000

3. Finish Analysis:
   When analysis is complete, unload the database and release resources with the following command:

   @workspace /unLoadAssetBundle

Available Tools

License

This project is licensed under the MIT License.

Acknowledgements

The core analysis functionality of this tool uses UnityDataTools. Many thanks to the developers of this excellent library.