MCP (Model Context Protocol) サーバは、Unsplash からproperアトリビューション で写真を取得します。 LLMは、適切にクレジットされた画像を必要とするコンテンツページを構築するために設計されています。

##特徴

-Search Photos - フィルター(色、方向)でキーワードで写真を見つける -Random Photos - 様々なコンテンツをランダムに表示

• トラッキングのダウンロード - Unsplash APIガイドラインに準拠 -フル属性 - すべての写真には、既製のアトリビューションテキストとHTMLが含まれています
• LLM-Optimized - 簡単に埋め込むための事前フォーマットされたアトリビューション文字列

#このサーバーはなぜですか?

Unsplash では、写真を使用する際の適切なアトリビューションが必要です。 このサーバは、以下のような操作で簡単に行えます。

• [attribution_text]: 「UnsplashのJohn Doeによる写真」のようなプレーンテキスト

インストール

前提条件

• Python 3.11 +
• Unsplash APIアクセスキー(ここで1つ取得)

クイックスタート

設定

##Claudeコード

[~/.claude.json (ユーザーレベル) または [.mcp.json] に追加します。

カーソル

Cursor MCP の設定に追加します。

##ウィンドサーフィン/クライン

MCP の設定に追加します。

ツール

##[search_photos

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: