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

# Transform Your Development Workflow: Unsplash Images at Your Fingertips

Adding the Unsplash MCP server to your Augment Code setup instantly transforms your AI assistant into a powerful visual content partner. No more breaking your flow to hunt for images in browser tabs – now Augment can search, find, and integrate high-quality, royalty-free photos directly into your development process.

## Seamless Visual Integration for Modern Development

This MCP server supercharges Augment Code with `search_photos` capabilities, letting you find perfect images for web applications, mobile apps, documentation, and prototypes without leaving your development environment. Whether you're building a portfolio site and need stunning landscape photos, creating a recipe app that requires food imagery, or developing marketing pages that need specific lifestyle shots, Augment can now search Unsplash's extensive library using natural language prompts like "modern office workspace" or "mobile app screenshots." The server returns properly formatted image URLs in multiple sizes (thumb, small, regular, full), complete with attribution details and direct download links.

## Productivity Gains That Actually Matter

The real power emerges when you ask Augment to "find hero images for this landing page and generate the HTML with proper image tags and alt text" or "search for icons that match this app's design system and create the component code." Instead of context-switching between your editor, browser, and image sites, Augment handles the entire workflow – from search to implementation. You get professional-quality visuals integrated directly into your code with proper attribution, responsive image handling, and optimized loading patterns. For developers working on client projects, demos, or personal applications, this MCP server eliminates the friction of finding and implementing visual assets, letting you maintain focus on building great software while ensuring your applications look polished and professional.

## Setup and Configuration

Add this server to your Augment Code configuration by updating your `settings.json` with the Unsplash MCP server details and your Unsplash API key. Once configured, simply ask Augment to search for images, and watch as it seamlessly integrates visual content discovery into your development workflow.
License: MIT License
Updated 7/15/2025

Table of Contents