The Unsplash MCP Server enables seamless integration of Unsplash image search and retrieval into applications.
- Advanced Image Search: Search Unsplash's photo library with filters for keyword relevance, color schemes (black, white, red, blue), and orientation (landscape, portrait, squarish).
- Customizable Results: Control pagination, specify sorting (by relevance or latest), and set the number of results per page (1-30).
- Rich Photo Data: Retrieve detailed information including unique IDs, descriptions, image URLs in various sizes, and dimensions.
- IDE Integration: Easily integrates with IDEs like Cursor, WindSurf, and Cline.
- Cross-Language Support: Available implementations in Golang and Java.
Provides advanced image search capabilities for Unsplash's photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.
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
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
📬 Contact
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A lightweight server that enables seamless integration with Unsplash's image library, allowing developers to search for high-quality photos with various filters directly from the Cursor editor.
- 📋 Overview
- ✨ Features
- 🔑 Obtaining Unsplash Access Key
- 🚀 Installation
- 🛠️ Available Tools
- 🔄 Other Implementations
- 📄 License
- 📬 Contact
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn intelligent MCP server with a fully automated batch pipeline for web-ready images. Features include noise reduction, auto levels/curves, JPEG artifact removal, 4K resizing, smart sharpening with shadow/highlight enhancement, and advanced WebP conversion.Last updated -15JavaScriptMIT License
- AsecurityAlicenseAqualityA simple MCP server that facilitates website fetching through a configurable server platform using stdio or SSE transport, allowing integration with tools like Cursor for streamlined access.Last updated -223PythonMIT License
- AsecurityAlicenseAqualityThis server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.Last updated -16MIT License
- -securityFlicense-qualityAn MCP server implementation that enables users to search, download Freepik resources, and generate images using Mystic AI through natural language requests.Last updated -JavaScript