okooo5km_unsplash_mcp_server_swift

okooo5km_unsplash_mcp_server_swift

by okooo5km
A Swift-based MCP server for searching, retrieving, and managing Unsplash photos with advanced filtering options.

Unsplash Photo Search and Retrieval MCP Server

A Swift-based Model Context Protocol (MCP) server that enables advanced photo search, retrieval, and random photo selection from Unsplash's extensive library. This implementation extends the original Python version with additional features like get_photo and random_photo.

Swift Platform License

✨ Features

  • Advanced Image Search: Search Unsplash's library with filters for keyword relevance, color schemes, orientation, and more.
  • Detailed Photo Information: Retrieve comprehensive details about specific photos, including EXIF data, location, and photographer information.
  • Random Photo Selection: Get random photos with flexible filtering options.

Available Tools

  • search_photos: Search for photos with customizable filters like query, page, perPage, orderBy, color, and orientation.
  • get_photo: Retrieve detailed information about a specific photo using its ID.
  • random_photo: Get one or more random photos with options for count, collections, topics, username, query, orientation, content_filter, and featured.

Installation

Option 1: One-Line Installation (curl)

Install the latest version with a single command:

curl -fsSL https://raw.githubusercontent.com/okooo5km/unsplash-mcp-server-swift/main/install.sh | bash

Option 2: Build from Source

  1. Clone the repository:
    shell git clone https://github.com/okooo5km/unsplash-mcp-server-swift.git cd unsplash-mcp-server-swift
  2. Build the project:
    shell swift build -c release
  3. Install the binary:
    shell mkdir -p ~/.local/bin cp $(swift build -c release --show-bin-path)/unsplash-mcp-server ~/.local/bin/ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # or ~/.bashrc source ~/.zshrc # or source ~/.bashrc

Configuration

Environment Variables

Set your Unsplash API access key:

export UNSPLASH_ACCESS_KEY="your-access-key-here"

Obtain an Unsplash API Access Key

  1. Visit the Unsplash Developers Portal.
  2. Sign up or log in.
  3. Register a new application and accept the API guidelines.
  4. Retrieve your Access Key (Client ID).

Configure for Claude.app

Add to your Claude settings:

"mcpServers": {
  "unsplash": {
    "command": "unsplash-mcp-server"
  }
}

Configure for Cursor

Add to your Cursor editor's settings.json:

{
  "mcpServers": {
    "unsplash": {
      "command": "unsplash-mcp-server",
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

Configure for Chatwise

Chatwise Configuration

Note: Do not wrap environment variable values in quotes when configuring Chatwise.

Development Requirements

  • Swift 6.0 or later
  • macOS 14.0 or later
  • Unsplash API access key
  • MCP Swift SDK 0.2.0 or later

Version History

For detailed version history and changelog, check the GitHub Releases.

☕️ Support the Project

If you find this project useful, consider supporting its development:

  • ⭐️ Star the project on GitHub
  • 🐛 Report bugs or suggest features
  • 🔄 Submit pull requests
  • 💝 Buy me a coffee

License

Licensed under the MIT License. See the LICENSE file for details.

Features & Capabilities

Categories
mcp_server model_context_protocol swift unsplash api_integration search random_photo photo_retrieval

Implementation Details

View on GitHub

Stats

0 Views
6 GitHub Stars

Repository Info

okooo5km Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI