用于从 Unsplash 取取照片的 MCP( 模式上下文协议) 服务器, 带有 ** 适当的属性** 。 为 LLMS 构建内容页所设计,需要正确贷记图像.

□ 特性

• ** 搜索相片** - 按关键字查找带有过滤器的照片(颜色,取向)
• Random相片 - 获取随机相片,以获取内容的多样性
• ** " 下载跟踪 " ** - 符合Unsplash API准则
• ** 完全归属** - 每张相片包括随时可用的归属文本和 HTML
• LLM-Optimized - 易于嵌入的预格式归属字符串

□为什么这个服务器?

使用照片时需要正确归属。 这个服务器通过包括:

• [[T0]: 简洁的文字,如"约翰·多伊在Unsplash上的照片"
• [[T1]: 完整 HTML 有适当的网页链接

□ 安装

· 先决条件

• Py 3.11+
• Unsplash API 访问密钥( 在此获得一个)

QQ 快速启动

□ 配置

克劳德密码

添加到您的 [[T2] (用户级别) 或工程 [[T3] 中 :

QQ 光标

添加到您的光标 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: