Unsplash MCP Server

🚀 Unsplash MCP サーバー

English | 繁体中文

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

🚀 クイックスタート

Unsplash MCPサーバーは、高品質の画像を検索するために使用されます。開発者がUnsplashの機能を自分のアプリケーションに統合するのに最適です。

✨ 主な機能

• 高度な画像検索：以下のフィルタ条件でUnsplashの膨大な画像ライブラリを検索できます。
  • キーワードの関連性
  • 配色
  • 方向オプション
  • カスタムソートとページング

🔑 Unsplashアクセスキーの取得

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

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

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

📦 インストール

Smitheryを使用して、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-****-****

手動インストール

# リポジトリをクローンする
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# プロジェクトディレクトリに移動する
cd unsplash-mcp-server

# 仮想環境を作成する
uv venv

# 依存関係をインストールする
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": "your_search_query",
  "page": 1,
  "per_page": 20
}

その他の実装

• Unsplash APIドキュメント
• Pythonサンプルコード

📄 ライセンス

MITライセンス

連絡先

• プロジェクトのURL：GitHub
• 作者のメールアドレス：[hello@katon.dev]