Content
[](https://mseep.ai/app/hellokaton-unsplash-mcp-server)
# Unsplash MCP Server
English | [简体中文](README_zh.md)
> A simple MCP server for seamless Unsplash image integration and search capabilities.
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://archestra.ai/mcp-catalog/hellokaton__unsplash-mcp-server)
[](https://skillselion.com/mcp/tool/io.github.hellokaton/unsplash-mcp-server)
## 📋 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](https://unsplash.com/developers)
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](https://unsplash.com/documentation).
## 🚀 Installation
To install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server):
### IDE Setup
**Cursor IDE**
```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****
```
**Windsurf**
```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****
```
**Cline**
```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****
```
### Manual Installation
```bash
# 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 `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)
<img src="screenshots/Snipaste_1.png" alt="Cursor Configuration Screenshot" />
```json
{
"mcpServers": {
"unsplash": {
"command": "uv",
"args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
"env": {
"UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
}
}
}
}
```
### Using in Cursor
<img src="screenshots/Snipaste_2.png" alt="Unsplash MCP in Cursor" />
## 🛠️ Available Tools
### Search Photos
```json
{
"tool": "search_photos",
"query": "mountain",
"per_page": 5,
"orientation": "landscape"
}
```
## 🔄 Other Implementations
- Golang: [unsplash-mcp-server](https://github.com/douglarek/unsplash-mcp-server)
- Java: [unsplash-mcp-server](https://github.com/JavaProgrammerLB/unsplash-mcp-server)
## 📄 License
[MIT License](LICENSE)
## 📬 Contact
- [Twitter/X](https://x.com/hellokaton)
- [GitHub Issues](https://github.com/hellokaton/unsplash-mcp-server/issues)
MCP Store