Unsplash
About
Integrates with Unsplash to enable keyword-based photo searches with filtering options for color, orientation, and sorting, returning structured image data including URLs, dimensions, and descriptions.
Details
- Author
- hellokaton
- Repository
- hellokaton/unsplash-mcp-server
- GitHub stars
- 143
- Downloads
- 533
- License
- MIT License
- Categories
- Search, Knowledge Base, Other, Productivity, Developer Tools, Design, AI, Media, Frontend, Security, Infrastructure
Jump to
- Advanced Image Search: Search Unsplash's extensive photo library with filters for:
- Keyword relevance
- Color schemes
- Orientation options
- Custom sorting and pagination
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
UnsplashCommand (node, npx, python, etc.)uvArguments-
Argument 1
run -
Argument 2
--with -
Argument 3
fastmcp -
Argument 4
fastmcp -
Argument 5
run -
Argument 6
./server.py
Environment-
UNSPLASH_ACCESS_KEY
$${YOUR_ACCESS_KEY}
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:
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--
uv venv
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}"
}
}
}
}
search_photos
Search for photos in the Unsplash library. Parameters: query (string), per_page (integer), orientation (string)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"unsplash": {
"env": {
"UNSPLASH_ACCESS_KEY": "$${YOUR_ACCESS_KEY}"
},
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"./server.py"
],
"command": "uv"
}
}
}Linux
{
"env": {
"UNSPLASH_ACCESS_KEY": "$${YOUR_ACCESS_KEY}"
},
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"./server.py"
],
"command": "uv"
}Macos
{
"env": {
"UNSPLASH_ACCESS_KEY": "$${YOUR_ACCESS_KEY}"
},
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"./server.py"
],
"command": "uv"
}Windows
{
"env": {
"UNSPLASH_ACCESS_KEY": "$${YOUR_ACCESS_KEY}"
},
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"./server.py"
],
"command": "uv"
}Unsplash MCP Server
English | 简体中文
> A simple MCP server for seamless Unsplash image integration and search capabilities.
📋 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.
✨ 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:
1. Create a developer account at Unsplash
2. Register a new application
3. Get your Access Key from the application details page
4. 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
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
