# Blendkit MCP Server

[![Python](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)

An unofficial [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that provides AI agents with direct access to the [BlenderKit](https://www.blenderkit.com/) 3D library. This server allows agents to seamlessly search for 3D assets (models, materials, HDRs, brushes) and retrieve native download URLs.

## Features

- **Asset Search**: Easily query the Blendkit library for 3D models, PBR materials, HDRs, brushes, and scenes.
- **Rich Context**: Returns simplified, agent-friendly asset metadata including thumbnails, asset IDs, file sizes, and descriptions.
- **Direct Downloads**: Retrieves direct download URLs for asset files, including texture packs and `.blend` files at varying resolutions, allowing the agent to download the assets natively using tools like `curl` or `wget`.

## Prerequisites

- **Python 3.13+**
- **uv** (Recommended, for fast dependency management)
- **Blendkit API Key**: While some assets are free, a Blendkit API key is highly recommended for higher rate limits and access to paid/private assets.

## Installation

Clone the repository and install the dependencies:

```bash
git clone https://github.com/RN0000/blendkit-mcp.git
cd blendkit-mcp

# Using uv
uv sync
```

## Configuration

The server requires a Blendkit API Key for authentication. You can pass it as an environment variable: `BLENDERKIT_API_KEY`.

### Connecting to an MCP Client (e.g., Claude Desktop)

To use this server with an MCP-compatible client like Claude Desktop, add the following configuration to your client's config file (e.g. `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "Blendkit": {
      "command": "uv",
      "args": [
        "run",
        "server.py"
      ],
      "cwd": "/path/to/your/blendkit-mcp",
      "env": {
        "BLENDERKIT_API_KEY": "<your-blendkit-api-key>"
      }
    }
  }
}
```

*Note: Replace `/path/to/your/blendkit-mcp` with the absolute path to where you cloned this repository, and `<your-blendkit-api-key>` with your actual key.*

## Available Tools

The server exposes the following MCP tools to the agent:

1. `search_blendkit_assets(query, asset_type, limit)`
   - **Description**: Searches the Blendkit library for 3D assets.
   - **Arguments**: 
     - `query` (string): The search term (e.g., 'chair', 'wood').
     - `asset_type` (string): Type of asset (`model`, `material`, `scene`, `hdr`, `brush`). Defaults to `model`.
     - `limit` (int): Number of results to return (max 15).
   
2. `get_asset_download_url(asset_id)`
   - **Description**: Retrieves the download URLs for a specific asset using its ID. Useful if the direct URLs weren't retrieved during search or for targeted queries.
   - **Arguments**:
     - `asset_id` (string): The UUID of the asset (`id` or `assetBaseId`).

## Usage Examples

Once connected, you can ask your AI assistant:
- *"Search Blendkit for a realistic wooden chair model."*
- *"Find me some 4K bark materials on Blendkit and get their download links."*
- *"Get the download URL for the Blendkit asset with ID ea74e54f-..."*

## Disclaimer

This is an unofficial community project and is not affiliated with, endorsed by, or sponsored by BlenderKit.