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:
- 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
uvis not in your system PATH, use an absolute path (e.g.,/path/to/uv) ./server.pyshould 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"
}
🔄 Other Implementations
- Golang: unsplash-mcp-server
- Java: unsplash-mcp-server