Navigation
Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration - MCP Implementation

Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration

Unleash Unsplash's visuals with our MCP server—blazing-fast image search, seamless API integration, and developer-friendly tools. Perfect for your next project.

Visit Repository
✨ Research And Data
4.4(179 reviews)
268 saves
125 comments

Users create an average of 54 projects per month with this tool

About Unsplash MCP Server

What is Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration?

Unsplash MCP Server is a lightweight tool designed for developers to effortlessly integrate and search Unsplash’s vast repository of high-resolution images. Built with speed and simplicity in mind, it offers a streamlined interface to access millions of photos while maintaining seamless API synchronization. Whether you're building a content management system or a creative platform, this server ensures your application can fetch, filter, and display images in real-time without compromising performance.

Key Features of Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration?

  • Lightning-fast search: Instantly filter images by keywords, categories, or metadata using optimized query algorithms.
  • Seamless API sync: Automatic updates from Unsplash’s database ensure you always have the latest content.
  • Multi-editor support: Works flawlessly with popular IDEs like VS Code, JetBrains, and Atom.
  • Customizable workflows: Configure search parameters, caching rules, and authentication settings to match your project’s needs.

Unsplash MCP Server Features

How to Use Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration?

Installation Options

Choose your preferred setup method:


# Automatic installation (recommended)
npm install unsplash-mcp --save

# Manual setup (for advanced users)
git clone https://github.com/unsplash/mcp-server.git
cd mcp-server
npm install

Configuration

1. Generate an API access key from Unsplash Developers.

2. Configure your IDE with these parameters:


{
  "api_key": "YOUR_ACCESS_TOKEN",
  "cache_ttl": "3600",
  "search_filters": ["minimal", "portrait"]
}

Use Cases of Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration?

1. E-commerce platforms: Dynamically populate product galleries with relevant imagery without manual uploads.

2. Blogging tools: Auto-generate visually engaging posts by pairing search terms with matching visuals.

3. Marketing dashboards: Create real-time moodboards using filtered search results and collaborative editing features.

4. AR/VR applications:

Unsplash MCP Server FAQ

FAQ from Unsplash MCP Server: Blazing-Fast Search & Seamless API Integration?

How do I handle API rate limits?

Implement caching strategies using the built-in cache_ttl parameter. For enterprise use cases, contact [email protected] for premium access.

Does it support image preprocessing?

Yes! Apply on-the-fly transformations like resizing, cropping, and format conversion via query parameters. Example: /search?query=nature&width=800&format=webp

My search results are outdated – what’s wrong?

Check your cache settings. Run mcp clear-cache to force an API refresh. If issues persist, verify your access token permissions in the Unsplash developer dashboard.

Content

Unsplash MCP Server

English | 简体中文

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

Python 3.9+ License: MIT smithery badge

📋 Overview

Unsplash MCP Server is used for searching rich, high-quality images. It's ideal for developers who want to integrate Unsplash functionality into their own applications.

✨ Features

  • Advanced Image Search : Search Unsplash's extensive photo library with filters for:
    • Keyword relevance
    • Color schemes
    • Orientation options
    • Custom sorting and pagination

🔑 Obtaining Unsplash Access Key

Before installing this server, you'll need to obtain an Unsplash API Access Key:

  1. Create a developer account at Unsplash
  2. Register a new application
  3. Get your Access Key from the application details page
  4. Use this key in the configuration steps below

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

🚀 Installation

To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:

IDE Setup

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:

⚠️ Note: Please adjust the following configuration according to your actual installation:

  • If uv is not in your system PATH, use an absolute path (e.g., /path/to/uv)
  • ./server.py should be modified to the actual location of your server script (can use absolute path or path relative to workspace)
Cursor Configuration Screenshot 
{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

Using in Cursor

Unsplash MCP in Cursor

🛠️ Available Tools

Search Photos

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

🔄 Other Implementations

📄 License

MIT License

📬 Contact

Related MCP Servers & Clients

python3mcp-server

Quick Navigation

MCP Categories

Research And Data