Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hellokaton--unsplash-mcp-server/badge.svg)](/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

i

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)

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/hellokaton-unsplash-mcp-server-badge.png)](https://mseep.ai/app/hellokaton-unsplash-mcp-server)
  2. # Unsplash MCP Server
  3. English | [็ฎ€ไฝ“ไธญๆ–‡](README_zh.md)
  4. > A simple MCP server for seamless Unsplash image integration and search capabilities.
  5. [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/hellokaton/unsplash-mcp-server)](https://archestra.ai/mcp-catalog/hellokaton__unsplash-mcp-server)
  8. [![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.hellokaton/unsplash-mcp-server.svg)](https://skillselion.com/mcp/tool/io.github.hellokaton/unsplash-mcp-server)
  9. ## ๐Ÿ“‹ Overview
  10. 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.
  11. ## โœจ Features
  12. - **Advanced Image Search**: Search Unsplash's extensive photo library with filters for:
  13. - Keyword relevance
  14. - Color schemes
  15. - Orientation options
  16. - Custom sorting and pagination
  17. ## ๐Ÿ”‘ Obtaining Unsplash Access Key
  18. Before installing this server, you'll need to obtain an Unsplash API Access Key:
  19. 1. Create a developer account at [Unsplash](https://unsplash.com/developers)
  20. 2. Register a new application
  21. 3. Get your Access Key from the application details page
  22. 4. Use this key in the configuration steps below
  23. For more details, refer to the [official Unsplash API documentation](https://unsplash.com/documentation).
  24. ## ๐Ÿš€ Installation
  25. To install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server):
  26. ### IDE Setup
  27. **Cursor IDE**
  28. ```bash
  29. npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****
  30. ```
  31. **Windsurf**
  32. ```bash
  33. npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****
  34. ```
  35. **Cline**
  36. ```bash
  37. npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****
  38. ```
  39. ### Manual Installation
  40. ```bash
  41. # Clone the repository
  42. git clone https://github.com/hellokaton/unsplash-mcp-server.git
  43. # Navigate to project directory
  44. cd unsplash-mcp-server
  45. # Create virtual environment
  46. uv venv
  47. # Install dependencies
  48. uv pip install .
  49. ```
  50. **Cursor Editor Integration**
  51. Add the following configuration to your Cursor editor's `settings.json`:
  52. โš ๏ธ **Note:** Please adjust the following configuration according to your actual installation:
  53. - If `uv` is not in your system PATH, use an absolute path (e.g., `/path/to/uv`)
  54. - `./server.py` should be modified to the actual location of your server script (can use absolute path or path relative to workspace)
  55. <img src="screenshots/Snipaste_1.png" alt="Cursor Configuration Screenshot" />
  56. ```json
  57. {
  58. "mcpServers": {
  59. "unsplash": {
  60. "command": "uv",
  61. "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
  62. "env": {
  63. "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
  64. }
  65. }
  66. }
  67. }
  68. ```
  69. ### Using in Cursor
  70. <img src="screenshots/Snipaste_2.png" alt="Unsplash MCP in Cursor" />
  71. ## ๐Ÿ› ๏ธ Available Tools
  72. ### Search Photos
  73. ```json
  74. {
  75. "tool": "search_photos",
  76. "query": "mountain",
  77. "per_page": 5,
  78. "orientation": "landscape"
  79. }
  80. ```
  81. ## ๐Ÿ”„ Other Implementations
  82. - Golang: [unsplash-mcp-server](https://github.com/douglarek/unsplash-mcp-server)
  83. - Java: [unsplash-mcp-server](https://github.com/JavaProgrammerLB/unsplash-mcp-server)
  84. ## ๐Ÿ“„ License
  85. [MIT License](LICENSE)
  86. ## ๐Ÿ“ฌ Contact
  87. - [Twitter/X](https://x.com/hellokaton)
  88. - [GitHub Issues](https://github.com/hellokaton/unsplash-mcp-server/issues)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.