mcpField
U
Unsplash MCP Server

Unsplash MCP Server

Local
github.com/hellokatonMedia & Design237Updated 2w ago
Repository

About Unsplash MCP Server

Unsplash MCP Server is a Python MCP server for searching high-quality images from the Unsplash library. It is intended for developers who want to add Unsplash search to their own applications.

Key features

  1. 01Keyword search across the Unsplash photo library
  2. 02Filters for color scheme and orientation
  3. 03Custom sorting and pagination
  4. 04Access key based Unsplash API access

Use cases

  1. 01Finding images for articles or application content
  2. 02Searching for landscape or portrait photos from an IDE assistant

MCP support

This project is an MCP server that exposes a search_photos tool to MCP clients for searching Unsplash photos with filters.

#python3#mcp-server#unsplash-mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "unsplash": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MseeP.ai Security Assessment Badge

Unsplash MCP Server

English | 简体中文

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

Python 3.9+ License: MIT

Trust Score Listed on Skillselion

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.