Сервер MCP (Model Context Protocol) для получения фотографий из Unsplash с правильной атрибуцией. Предназначен для создания страниц контента LLM, которые нуждаются в правильно зачисленных изображениях.

Особенности

• Поиск фотографий - Поиск фотографий по ключевым словам с помощью фильтров (цвет, ориентация) Random Photos - Получите случайные фотографии для разнообразия контента Download Tracking - в соответствии с рекомендациями Unsplash API ** Полная атрибуция ** - Каждая фотография включает в себя готовый к использованию текст атрибуции и HTML LLM-Optimized - предварительно отформатированные строки атрибуции для легкого встраивания

##Почему именно этот сервер?

Unsplash требует правильной атрибуции при использовании своих фотографий. Этот сервер упрощает включение:

• [[Т0]]: Текст песни «Photo by John Doe on Unsplash»
• [[Т1]]: Полный HTML с правильными ссылками на веб-страницы

##Установка

Предпосылки

Python 3.11+

• Ключ доступа к API Unsplash (Получить один здесь)

###Быстрый старт

Конфигурация

###Клауд Код

Добавьте к своему ~/.claude.json (уровень пользователя) или проекту .mcp.json:

Курсор

Добавьте настройки Cursor MCP:

Виндсерф / Клайн

Добавьте свою конфигурацию MCP:

Инструменты

[[Т4]]

Unsplash MCP Server

An MCP (Model Context Protocol) server for fetching photos from Unsplash with proper attribution. Designed for LLMs building content pages that need properly credited images.

Features

• Search Photos - Find photos by keyword with filters (color, orientation)
• Random Photos - Get random photos for variety in content
• Download Tracking - Compliant with Unsplash API guidelines
• Full Attribution - Every photo includes ready-to-use attribution text and HTML
• LLM-Optimized - Pre-formatted attribution strings for easy embedding

Why This Server?

Unsplash requires proper attribution when using their photos. This server makes it easy by including:

• attribution_text: Plain text like “Photo by John Doe on Unsplash”
• attribution_html: Full HTML with proper links for web pages

Photo by John Doe on Unsplash

Installation

Prerequisites

• Python 3.11+
• An Unsplash API access key (Get one here)

Quick Start

# Clone the repository
git clone https://github.com/cevatkerim/unsplash-mcp.git
cd unsplash-mcp

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install fastmcp httpx python-dotenv

# Set your API key
echo "UNSPLASH_ACCESS_KEY=your_key_here" > .env

# Run the server
fastmcp run server.py

Configuration

Claude Code

Add to your ~/.claude.json (user-level) or project .mcp.json:

{
  "mcpServers": {
    "unsplash": {
      "type": "stdio",
      "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
      "args": ["run", "/path/to/unsplash-mcp/server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "unsplash": {
      "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
      "args": ["run", "/path/to/unsplash-mcp/server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

Windsurf / Cline

Add to your MCP configuration:

{
  "unsplash": {
    "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
    "args": ["run", "/path/to/unsplash-mcp/server.py"],
    "env": {
      "UNSPLASH_ACCESS_KEY": "your_access_key_here"
    }
  }
}

Tools

search_photos

Search for photos by keyword with optional filters.

Parameters: