mcp-registry/unsplash-mcp-server

    ==================
      
       /// MCP ///
      /// UNS ///
        
    ==================
        
    [server:online]
    [protocol:ready]

unsplash-mcp-server

by hellokaton

A minimal MCP server that exposes Unsplash image-search as an MCP tool.

144
16
Specialized
GitHub

01

search_photos

Search Unsplash’s photo library using keywords and optional filters such as color, orientation, sorting, and pagination

Installation

1. Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git cd unsplash-mcp-server
2. (Recommended) Create and activate a virtual environment
python3 -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
3. Install Python dependencies
pip install -r requirements.txt
4. Supply your Unsplash credentials
export UNSPLASH_ACCESS_KEY=<your_access_key> # Optional if the code also needs a secret export UNSPLASH_SECRET_KEY=<your_secret_key>
5. Start the MCP server
python main.py # or: uvicorn main:app --reload The server will start on http://localhost:8000 (or the port defined in main.py).

Documentation

License: MIT License
Updated 7/15/2025