📌Overview

Purpose: The Unsplash MCP Server aims to provide seamless integration and search capabilities for high-quality images from Unsplash.

Overview: This server is designed specifically for developers looking to include Unsplash's extensive image library in their applications, offering a simplified way to access and search for images.

Key Features:

Advanced Image Search: Allows users to search Unsplash's vast photo library using various filters, including keyword relevance, color schemes, orientation options, and the ability to customize sorting and pagination.

Unsplash MCP Server

English | 1

A simple MCP server for seamless Unsplash image integration and search capabilities.

📋 Overview

Unsplash MCP Server is designed for searching rich, high-quality images, making it ideal for developers who want to integrate Unsplash functionality into their applications.

✨ Features

Advanced Image Search: Search Unsplash's extensive photo library with keyword relevance, color schemes, orientation options, and custom sorting.

🔑 Obtaining Unsplash Access Key

To use this server, you'll need to obtain an Unsplash API Access Key:

Create a developer account at Unsplash.
Register a new application.
Get your Access Key from the application details page.

For more details, refer to the official Unsplash API documentation.

🚀 Installation

Automatic Installation via Smithery

To install the Unsplash MCP Server automatically:

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Manual Installation

# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# Navigate to project directory
cd unsplash-mcp-server

# Create virtual environment
uv venv

# Install dependencies
uv pip install .

Cursor Editor Integration

Add the following configuration to your Cursor editor's settings.json:

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

🛠️ Available Tools

Search Photos

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

unsplash-mcp-server