Unsplash MCP Server
by okooo5km
The Unsplash MCP Server is a Swift implementation of a Model Context Protocol server that provides Unsplash photo search and retrieval capabilities. It allows LLMs to search, retrieve, and get random photos from Unsplash's extensive collection.
Last updated: N/A
What is Unsplash MCP Server?
This is a Swift-based Model Context Protocol (MCP) server designed to interface with the Unsplash API. It enables Large Language Models (LLMs) to access and utilize Unsplash's vast library of photos through a defined protocol.
How to use Unsplash MCP Server?
- Install the server using either the one-line installer or by building from source.
- Obtain an Unsplash API access key from the Unsplash Developers Portal and set it as an environment variable (
UNSPLASH_ACCESS_KEY). - Configure your application (e.g., Claude, Cursor, Chatwise) to use the server by specifying the command to execute the server and passing the API key.
- Use the available tools (
search_photos,get_photo,random_photo) to query Unsplash and retrieve photos.
Key features of Unsplash MCP Server
Advanced Image Search with keyword, color, and orientation filters
Detailed Photo Information retrieval including EXIF data
Random Photo Selection with flexible filtering options
Swift implementation with
get_photoandrandom_photofeatures
Use cases of Unsplash MCP Server
Enhancing LLM capabilities with visual content
Integrating Unsplash photos into applications and workflows
Building image-based search and retrieval systems
Providing visual context for AI-powered conversations
FAQ from Unsplash MCP Server
What is an Unsplash API access key and how do I get one?
What is an Unsplash API access key and how do I get one?
An Unsplash API access key is required to access the Unsplash API. You can obtain one by registering an application at the Unsplash Developers Portal.
How do I install the server?
How do I install the server?
You can install the server using the one-line installer or by building from source. Instructions for both methods are provided in the Installation section of the README.
How do I configure my application to use the server?
How do I configure my application to use the server?
The README provides configuration examples for Claude, Cursor, and Chatwise. You'll need to specify the command to execute the server and pass the Unsplash API access key.
What are the available tools?
What are the available tools?
The available tools are search_photos, get_photo, and random_photo. Each tool has specific parameters that you can use to customize your search.
What are the development requirements?
What are the development requirements?
The development requirements are Swift 6.0 or later, macOS 14.0 or later, an Unsplash API access key, and MCP Swift SDK 0.2.0 or later.