Hellokaton 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 --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"

手動インストール

# リポジトリをクローンする
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は、実際のサーバスクリプトの位置に変更してください（絶対パスまたはワークスペースからの相対パスを使用できます）。

// 設定例：
{
  "customCss": "",
  "customHtml": "",
  "language": "zh-CN",
  "theme": "vs-dark"
}

🛠️ ツール

依存関係のインストール

以下のツールがインストールされていることを確認してください。

• Python 3.9+
• Node.js（プロジェクトをビルドする場合）

サーバの起動

サーバを起動するには、以下のコマンドを実行します。

uv run server.py

http://localhost:5000にアクセスして結果を確認します。

📚 ドキュメント

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

🔗 その他の実装

• Unsplash公式サイト
• GitHubリポジトリ

ご利用いただき、ありがとうございます！何か問題があれば、いつでもメンテナに連絡してください。