unsplash-mcp-server
Author: hellokaton
Description: A minimal MCP server that exposes Unsplash image-search as an MCP tool.
Stars: 144
Forks: 16
License: MIT License
Category: Specialized
Overview
Installation
1. Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git
cd unsplash-mcp-server2. (Recommended) Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate3. Install Python dependencies
pip install -r requirements.txt4. 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).01
search_photos
Search Unsplash’s photo library using keywords and optional filters such as color, orientation, sorting, and pagination
License: MIT License
Updated 7/15/2025