hellokaton_unsplash_mcp_server
by hellokatonUnsplash Image Search MCP Server
A simple MCP server for seamless Unsplash image integration and search capabilities.
📋 Overview
The Unsplash MCP Server is designed to help developers integrate Unsplash's extensive photo library into their applications. It provides advanced search capabilities, making it ideal for projects that require high-quality images.
✨ 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 the 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 --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
Windsurf
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
Cline
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
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
📄 License
📬 Contact
About
🔎 A MCP server for Unsplash image search.
Topics
python3 mcp-server unsplash-mcp
Resources
License
Stars
Watchers
Forks
No releases published
Invite Gmail Contacts
