🖼️ Unsplash MCP Server深度测评：让AI助手秒变你的专业图片编辑

# 1. 确保已安装Node.js 18.x或更高版本
node --version

# 2. 克隆仓库
git clone https://github.com/drumnation/unsplash-smart-mcp-server.git
cd unsplash-smart-mcp-server

# 3. 安装依赖
npm install

# 4. 配置Cursor MCP设置
# 打开或创建文件：%USERPROFILE%\.cursor\mcp.json
# 添加以下配置[citation:1]：
{
  "mcpServers": {
    "stock_photo": {
      "command": "node",
      "args": ["./node_modules/.bin/tsx", "src/server.ts"],
      "disabled": false,
      "env": {
        "UNSPLASH_ACCESS_KEY": "你的API密钥"
      },
      "shell": false
    }
  }
}

# 5. 重启Cursor IDE

# 1. 克隆仓库并安装依赖（同上）
git clone https://github.com/drumnation/unsplash-smart-mcp-server.git
cd unsplash-smart-mcp-server
npm install

# 2. 编辑配置文件
nano ~/.cursor/mcp.json

# 3. 添加配置[citation:1]：
{
  "servers": {
    "unsplash": {
      "command": "npx",
      "args": ["tsx", "src/server.ts"],
      "cwd": "/完整的/路径/到/unsplash-smart-mcp-server",
      "env": {
        "UNSPLASH_ACCESS_KEY": "你的API密钥"
      }
    }
  }
}

# 4. 保存并重启Cursor

# docker-compose.yml
services:
  unsplash-mcp:
    build: .
    image: unsplash-mcp-server
    restart: always
    stdin_open: true
    tty: true
    environment:
      - UNSPLASH_ACCESS_KEY=你的API密钥

# 1. 确保已安装Python 3.9+和uv包管理器
python --version
pip install uv  # 如果尚未安装uv

# 2. 克隆仓库
git clone https://github.com/hellokaton/unsplash-mcp-server.git
cd unsplash-mcp-server

# 3. 创建虚拟环境并安装依赖
uv venv
uv pip install .[citation:7]

# 4. 配置Cursor
# 编辑Cursor的settings.json，添加[citation:6]：
{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "你的API密钥"
      }
    }
  }
}

# 对于Cursor IDE
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 你的API密钥[citation:6]

// 以下是与Claude的对话示例，不是实际代码
// 用户：我需要为一篇关于京都春季旅行的博客文章找配图
// 文章主题是传统与现代融合，需要一张封面图和3-4张内容配图

// Claude会调用Unsplash MCP Server，执行类似这样的搜索：
{
  "tool": "search_photos",
  "query": "Kyoto spring cherry blossoms traditional temple",
  "per_page": 5,
  "orientation": "landscape",
  "color": "pink" // 可选参数，限定粉色系
}

// 对于内容配图，Claude可能会分别搜索：
// 1. 京都街道樱花
// 2. 传统日式庭院
// 3. 现代京都城市景观
// 4. 日本茶道文化

# direct_unsplash_search.py
# 直接调用Unsplash API的示例（了解MCP背后的工作原理）

import requests
import json

class UnsplashSearcher:
    def __init__(self, access_key):
        self.access_key = access_key
        self.base_url = "https://api.unsplash.com"
        self.headers = {
            "Authorization": f"Client-ID {access_key}",
            "Accept-Version": "v1"
        }
    
    def search_photos(self, query, per_page=5, orientation=None, color=None):
        """模拟MCP服务器的搜索功能"""
        params = {
            "query": query,
            "per_page": per_page,
            "page": 1
        }
        
        if orientation:
            params["orientation"] = orientation  # landscape, portrait, squarish
        
        if color:
            params["color"] = color  # black_and_white, black, white, yellow, etc.
        
        response = requests.get(
            f"{self.base_url}/search/photos",
            headers=self.headers,
            params=params
        )
        
        if response.status_code == 200:
            data = response.json()
            return self._format_results(data["results"])
        else:
            print(f"Error: {response.status_code}")
            return []
    
    def _format_results(self, results):
        """格式化结果，类似MCP服务器的返回格式"""
        formatted = []
        for photo in results:
            formatted.append({
                "id": photo["id"],
                "description": photo.get("alt_description", photo.get("description", "")),
                "urls": photo["urls"],
                "width": photo["width"],
                "height": photo["height"],
                "photographer": {
                    "name": photo["user"]["name"],
                    "username": photo["user"]["username"],
                    "profile_link": photo["user"]["links"]["html"]
                }
            })
        return formatted
    
    def generate_attribution(self, photo_data):
        """生成图片署名信息 - MCP服务器自动执行的功能"""
        return f"Photo by {photo_data['photographer']['name']} on Unsplash"

# 使用示例
if __name__ == "__main__":
    # 初始化搜索器（使用你的API密钥）
    searcher = UnsplashSearcher("YOUR_UNSPLASH_ACCESS_KEY")
    
    # 搜索京都樱花图片
    results = searcher.search_photos(
        query="Kyoto cherry blossoms temple",
        per_page=3,
        orientation="landscape"
    )
    
    # 输出结果
    for i, photo in enumerate(results, 1):
        print(f"\n--- 图片 {i} ---")
        print(f"描述: {photo['description']}")
        print(f"尺寸: {photo['width']}x{photo['height']}")
        print(f"小图URL: {photo['urls']['small']}")
        print(f"摄影师: {photo['photographer']['name']}")
        
        # 生成署名
        attribution = searcher.generate_attribution(photo)
        print(f"署名信息: {attribution}")