What can you do with this server?

The Unsplash MCP Server enables seamless integration of Unsplash image search and retrieval into applications. * **Advanced Image Search**: Search Unsplash's photo library with filters for keyword relevance, color schemes (black, white, red, blue), and orientation (landscape, portrait, squarish). * **Customizable Results**: Control pagination, specify sorting (by relevance or latest), and set the number of results per page (1-30). * **Rich Photo Data**: Retrieve detailed information including unique IDs, descriptions, image URLs in various sizes, and dimensions. * **IDE Integration**: Easily integrates with IDEs like Cursor, WindSurf, and Cline. * **Cross-Language Support**: Available implementations in Golang and Java.

Which integrations are available for this server?

Provides advanced image search capabilities for [Unsplash](/mcp/servers/integrations/unsplash)'s photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.

The Unsplash MCP Server enables seamless integration of Unsplash image search and retrieval into applications.

Advanced Image Search: Search Unsplash's photo library with filters for keyword relevance, color schemes (black, white, red, blue), and orientation (landscape, portrait, squarish).
Customizable Results: Control pagination, specify sorting (by relevance or latest), and set the number of results per page (1-30).
Rich Photo Data: Retrieve detailed information including unique IDs, descriptions, image URLs in various sizes, and dimensions.
IDE Integration: Easily integrates with IDEs like Cursor, WindSurf, and Cline.
Cross-Language Support: Available implementations in Golang and Java.

Unsplash MCP Server

English | 简体中文

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

Python 3.9+ License: MIT

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

Related MCP server: Smart Photo Journal MCP Server

✨ 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:

Create a developer account at Unsplash
Register a new application
Get your Access Key from the application details page
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" }

Unsplash MCP Server

Unsplash MCP Server

📋 Overview

✨ Features

🔑 Obtaining Unsplash Access Key

🚀 Installation

IDE Setup

Manual Installation

Using in Cursor

🛠️ Available Tools

Search Photos

🔄 Other Implementations

📄 License

📬 Contact

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API