remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides advanced image search capabilities for Unsplash's photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.

Unsplash MCP サーバー

英語 |简体中文

シームレスな Unsplash 画像統合と検索機能を実現するシンプルな MCP サーバー。

📋 概要

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

✨ 特徴

高度な画像検索: Unsplash の豊富な写真ライブラリをフィルターで検索します。
- キーワードの関連性
- カラースキーム
- 方向オプション
- カスタムソートとページ区切り

🔑 Unsplashアクセスキーの取得

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

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

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

🚀 インストール

Smithery経由で Claude Desktop 用の Unsplash Image Integration Server を自動的にインストールするには:

IDEセットアップ

カーソルIDE

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

ウィンドサーフィン

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

クライン

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 .

カーソルエディターの統合

カーソルエディターの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}"
      }
    }
  }
}

カーソル内で使用する

🛠️ 利用可能なツール

写真を検索

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

🔄その他の実装

Golang: unsplash-mcp-server
Java: unsplash-mcp-server

📄 ライセンス

MITライセンス

📬 お問い合わせ

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search_photos

Unsplash の画像ライブラリとのシームレスな統合を可能にする軽量サーバー。開発者はカーソルエディターから直接、さまざまなフィルターを使用して高品質の写真を検索できます。

Related Resources

Reddit Discussion about this server

Unsplash MCP Server