Unsplash MCP Server

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

📋 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:

Create a developer account at Unsplash
Register a new application
Get your Access Key from the application details page
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 --key 7558c683-****-****

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****

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)

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

Using in Cursor

🛠️ Available Tools

Search Photos

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

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

search_photos

A lightweight server that enables seamless integration with Unsplash's image library, allowing developers to search for high-quality photos with various filters directly from the Cursor editor.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Cloudinary MCP Server
felores
A
security
A
license
A
quality
This server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.
Last updated -
1
71
4
JavaScript
MIT License
Smart Photo Journal MCP Server
Siddhant-K-code
A
security
A
license
A
quality
This MCP server aids users in searching and analyzing their photo library by location, labels, and people, offering functionalities like photo analysis and fuzzy matching for enhanced photo management.
Last updated -
14
Python
MIT License
MCP Image Placeholder Server
husniadil
A
security
A
license
A
quality
This server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.
Last updated -
1
6
MIT License
mcp_search_images
yanjunz
-
security
A
license
-
quality
A search service based on multiple image APIs and icon generation capabilities, specifically designed for integration with Cursor MCP service. Supports image search, download, and AI-generated icons.
Last updated -
2
Python
MIT License

View all related MCP servers

Unsplash MCP Server