Unsplash MCP Server

Unsplash MCP サーバー

英語 | 簡体字中国語

Unsplash の画像をシームレスに統合し、検索機能を利用できるシンプルな MCP サーバーです。

📋 概要

Unsplash MCP サーバーは、豊富で高品質な画像の検索に使用します。Unsplash の機能を独自のアプリケーションに統合したい開発者に最適です。

✨ 機能

• 高度な画像検索：Unsplash の豊富な写真ライブラリを、次のフィルターを使って検索できます。
  • キーワードの関連性
  • 配色
  • 画像の向き
  • カスタムの並べ替えとページネーション

🔑 Unsplash アクセスキーの取得

このサーバーをインストールする前に、Unsplash API アクセスキーを取得する必要があります。

1. Unsplash で開発者アカウントを作成します
2. 新しいアプリケーションを登録します
3. アプリケーションの詳細ページでアクセスキーを取得します
4. 以下の設定手順でこのキーを使用します

詳しくは、Unsplash API の公式ドキュメントを参照してください。

🚀 インストール

Smithery を使って、Claude Desktop 用の Unsplash 画像統合サーバーを自動的にインストールします。

IDE のセットアップ

Cursor IDE

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****

手動インストール

# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# Navigate to project directory
cd unsplash-mcp-server

# Create virtual environment
uv venv

# Install dependencies
uv pip install .

Cursor エディターとの統合

次の設定を Cursor エディターの settings.json に追加します。

⚠️ **注意：**実際のインストール環境に合わせて、以下の設定を調整してください。

• uv がシステムの PATH にない場合は、絶対パス（例：/path/to/uv）を使用してください
• ./server.py はサーバースクリプトの実際の場所に変更してください（絶対パス、またはワークスペースからの相対パスを使用できます）

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

Cursor での使用方法

🛠️ 利用可能なツール

写真を検索

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 その他の実装

• Golang：unsplash-mcp-server
• Java：unsplash-mcp-server

📄 ライセンス

MIT ライセンス

📬 お問い合わせ

• Twitter/X
• GitHub の課題