unsplash-mcp-server
๐ A MCP server for Unsplash image search.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hellokaton--unsplash-mcp-server)HTML
<a href="/listings/hellokaton--unsplash-mcp-server"><img src="/api/listings/hellokaton--unsplash-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
To install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server):
IDE Setup
**Cursor IDE**
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****
**Windsurf**
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****
**Cline**
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****
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 `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)
{
"mcpServers": {
"unsplash": {
"command": "uv",
"args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
"env": {
"UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
}
}
}
}Using in Cursor
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md ยท README ยท 132 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [](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)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itโs helped, pass it on.