MCP (Model Context Protocol) 서버는 proper attribution로 Unsplash에서 사진을 찍을 수 있습니다. 제대로 신용 이미지가 필요한 LLMs 빌딩 콘텐츠 페이지를 위해 설계되었습니다.

특징

-Search Photos - 필터 (컬러, 오리엔테이션)로 키워드로 사진을 찾습니다.

• Random Photos - 다양한 콘텐츠에 대한 무작위 사진 받기 -Download Tracking - Unsplash API 가이드와 호환
• Full Attribution - 모든 사진은 준비된 사용 권한 텍스트와 HTML을 포함합니다. -LLM-Optimized - 쉬운 embedding을 위한 Pre-formatted attribution 끈

왜 이 서버?

Unsplash는 사진을 사용할 때 적절한 attribution을 요구합니다. 이 서버는 다음과 같이 쉽게 합니다:

• attribution_text: 일반 텍스트 같은 “Photo by John Doe on Unsplash”
• attribution_html: 웹 페이지에 적합한 링크가있는 전체 HTML

설치

# 필수품

• 파이썬 3.11+
• Unsplash API 액세스 키 (여기를 얻으십시오)

빠른 시작

구성

Claude 코드

~/.claude.json] (user-level) 또는 프로젝트 .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: