PolyHaven MCP Server

An Model Context Protocol (MCP) server that provides agents and AI assistants access to the PolyHaven 3D asset library.

This server allows you to search, query, and retrieve download links for high-quality, CC0 HDRIs, textures, and 3D models directly through your AI assistant.

Features

This server exposes several tools that map directly to the PolyHaven public API:

• get_asset_types: Lists available asset types (hdris, textures, models).
• search_assets: Search for assets, optionally filtered by type and categories.
• get_asset_info: Retrieve detailed metadata and information about a specific asset by its ID.
• get_asset_files: Get a list of files for a specific asset, including direct download URLs for various formats and resolutions.
• get_categories: View available categories for a given asset type (and their asset counts).
• get_author_info: Retrieve information about a specific author.

Installation

Prerequisites

• Node.js (v16 or higher)
• npm

Setup

1. Clone this repository:

   git clone https://github.com/RN0000/polyhaven-mcp.git
   cd polyhaven-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Usage with MCP Clients

To use this server with an MCP-compatible client (such as Claude Desktop or Antigravity), you need to configure your client to launch the server.

Example Configuration

Add the following to your MCP client's configuration file:

{
  "mcpServers": {
    "polyhaven": {
      "command": "node",
      "args": [
        "/absolute/path/to/polyhaven-mcp/build/index.js"
      ]
    }
  }
}

Make sure to replace /absolute/path/to/polyhaven-mcp/build/index.js with the actual path to the compiled index.js file on your system.

Regarding API Usage

While this MCP server helps you connect to PolyHaven's API, this project is not affiliated with, endorsed by, or officially connected to PolyHaven in any way.

PolyHaven is generous enough to offer their API for free when used for non-commercial projects and academic research. If you're building something commercial, you'll need to reach out to them for a custom license or sponsorship. Be sure to check out PolyHaven's Terms of Service to make sure you're abiding by their terms of Service.

License

This project is licensed under the ISC License. See the package.json for more details. PolyHaven's assets are distributed under the CC0 license.