hellokaton/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**
**Windsurf**
**Cline**
Manual Installation
**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)
Using in Cursor
🛠️ Available Tools
Search Photos
🔄 Other Implementations
- Golang: unsplash-mcp-server
- Java: unsplash-mcp-server
📄 License
MIT License
📬 Contact
- Twitter/X
- GitHub Issues