Unsplash MCP Server

English | 简体中文

A simple MCP server for seamless Unsplash image integration and search capabilities.

📃 Overview

The Unsplash MCP Server facilitates searching high-quality images from Unsplash, ideal for developers integrating Unsplash functionality into applications.

✨ Features

• Advanced Image Search: Search Unsplash's photo library with filters for keyword relevance, color schemes, orientation options, custom sorting, and pagination.

🔑 Obtaining Unsplash Access Key

1. Create a developer account at Unsplash
2. Register a new application
3. Get your Access Key
4. Use this key in the configuration steps. Refer to the official Unsplash API documentation.

🚀 Installation

Automatic installation via Smithery is supported for IDEs like Cursor, Windsurf, and Cline, using npx commands with configuration options. Manual installation involves cloning the repository, creating a virtual environment using uv venv, and installing dependencies with uv pip install .. Cursor editor integration requires configuring settings.json with the server command and environment variables, including the Unsplash Access Key.

🛠️ 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

MIT License

💬 Contact

• Twitter/X
• GitHub Issues