Upsplash MCP Server

🚀 Unsplash プロジェクトドキュメント

このプロジェクトは、Unsplash API とのインタラクションを実現する MCP（管理制御平面）サーバーです。ユーザーはコマンドラインツールを通じて、画像の検索とダウンロードが可能です。

🚀 クイックスタート

このセクションでは、Unsplash MCP サーバーの基本的な使い方を説明します。まずは、以下の手順に従ってサーバーをセットアップしましょう。

✨ 主な機能

1. 画像検索
   • キーワード、作者、その他のフィルタ条件を使って、Unsplash 上の画像を検索できます。
2. ページング表示
   • 指定した件数でページごとに結果を取得できるため、大量のデータを扱いやすくなります。
3. 方向でのフィルタリング
   • 垂直または水平方向の画像を選択して検索できます。
4. ダウンロード機能
   • 小、中、大などの異なる解像度の画像をダウンロードできます。
5. 環境設定
   • 環境変数 UNSPLASH_ACCESS_KEY を使ってアクセスキーを設定することで、認証が容易になります。

📦 インストール

ダウンロードとインストール

方法一：Git を使ってリポジトリをクローンする

git clone https://github.com/yourusername/unsplash-mcp-server.git
cd unsplash-mcp-server

方法二：npm を使ってインストールする（npm に公開されている場合）

npm install -g unsplash-mcp-server

サーバーの起動

• 開発モード

  npm run dev
  

• 本番環境

  npm start
  

💻 使用例

画像検索 (search_photos)

サンプルコマンド：

cline search_photos --query "nature" --per_page 10 --orientation landscape

入力パラメータ：

• --query: 必須。検索キーワードです。
• --page: オプション。デフォルトは 1 ページ目です。
• --per_page: 1 ページあたりの結果数。デフォルトは 20 です。
• --orientation: オプション。画像の方向をフィルタする（portrait または landscape）。

出力結果： 画像 ID、URL などの情報を含む JSON 形式の検索結果リストが返されます。

画像ダウンロード (download_photo)

サンプルコマンド：

cline download_photo --photo_id abc123 --size large

入力パラメータ：

• --photo_id: 必須。対象画像の一意の識別子です。
• --size: オプション。デフォルトは中解像度です。

🔧 技術詳細

環境設定

.env ファイルを作成または編集し、以下の内容を追加します。

UNSPLASH_ACCESS_KEY=your_actual_key_here

コードリポジトリ

• GitHub リポジトリ: Unsplash API MCP サービス（yourusername を実際の GitHub アカウントに置き換えてください）
• ローカル開発: /path/to/your/unsplash-mcp-server/build/index.js

Cline を使った MCP サーバーの設定

プロジェクトの .roo/mcp.json ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "unsplash-mcp-server": {
      "command": "bun",
      "args": [
        "/path/to/your/unsplash-mcp-server/build/index.js"
      ],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_actual_key_here"
      }
    }
  }
}

開発ガイド

スクリプトの実行

• 開発モード

  npm run dev
  

• 本番ビルド

  npm run build
  

監視とデバッグ

npm run watch コマンドを使ってコードの変更をリアルタイムに監視し、npm run lint でコードをチェックできます。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。

⚠️ 重要な注意事項

バッジリンク内のユーザー名 "benjaming" は、実際の中国語のプロジェクト責任者またはチーム名に置き換える必要があります。また、GitHub リポジトリの URL 内の yourusername も実際の GitHub アカウントに置き換えてください。