Unsplash
    Unsplash

    Unsplash

    🔎 A MCP server for Unsplash image search.

    4.3

    GitHub Stats

    Stars

    143

    Forks

    15

    Release Date

    6/16/2025

    about three weeks ago

    Detailed Description

    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 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 --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"
    }
    

    🔄 Other Implementations

    📄 License

    MIT License

    📬 Contact

    Star History

    Star History

    Mar 18Mar 23Apr 1Apr 8Apr 13Apr 19Apr 30May 19May 31Jul 604080120160
    Powered by MSeeP Analytics

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.