Pexels MCP Server

Pexels MCP サーバー

Pexels API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。AI モデルが Pexels の写真、動画、コレクションを検索して取得できます。

機能

• クエリ、向き、サイズ、色で写真や動画を検索
• Pexels の厳選コンテンツや人気コンテンツにアクセス
• Pexels のコレクションを閲覧
• 特定の写真や動画の詳細情報を取得
• ツールまたは直接 URI リソースを介してコンテンツにアクセス

要件

• Node.js 18 以降
• Pexels API キー（https://www.pexels.com/api/ で取得）

ローカル開発

1. リポジトリをクローンします
2. 依存関係をインストールします

   pnpm install
   

3. プロジェクトをビルドします

   pnpm build
   

4. 開発モードで実行します

   PEXELS_API_KEY=your_api_key pnpm dev
   

Smithery へのデプロイ

この MCP サーバーは Smithery にデプロイできる状態です。次の手順に従ってください。

1. サーバーを Smithery に追加するか、既存のサーバーを登録します
2. Deployments タブに移動します（認証済みのオーナーにのみ表示されます）
3. サーバーをデプロイします
4. デプロイの設定時に、設定項目で Pexels API キーを指定します

API の使用方法

このサーバーは次のツールを提供します。

写真ツール

• searchPhotos：クエリで写真を検索します（関連性の高い結果を得るには、単に「hotel」や「car」とするのではなく、「Thai hotel reception」や「red sports car driving」などの具体的なキーワードを使用し、orientation、size、color、locale などのパラメーターと組み合わせると、結果を絞り込めます）。向き、サイズ、色、ロケール（例：'en-US'、'es-ES'）、ページ、1 ページあたりの結果数で任意に絞り込めます。写真 ID や URL などのメタデータと、現在の API レート制限状況を返します。
• downloadPhoto：ID と希望するサイズ（省略可能。既定値は 'original'）を指定して写真を取得します。利用可能なサイズは 'original'、'large2x'、'large'、'medium'、'small'、'portrait'、'landscape'、'tiny' です。指定した画像サイズの直接ダウンロードリンク、サイズを含む推奨ファイル名、帰属表示情報を返します。AI クライアントは、利用可能なローカルツール（curl や PowerShell の Invoke-WebRequest など）を使用して、提供されたリンクから写真をダウンロードしてください。
• getCuratedPhotos：Pexels の厳選された写真セットを取得します。ページネーションも任意で指定できます。
• getPhoto：ID で指定した写真の詳細情報を取得します。

動画ツール

• searchVideos：クエリで動画を検索します（関連性の高い結果を得るには、単に「beach」や「city」とするのではなく、「drone footage beach sunset」や「time lapse city traffic」などの具体的なキーワードを使用し、orientation や size などのパラメーターと組み合わせると、結果を絞り込めます）。向き、サイズ、ロケール（例：'en-US'、'es-ES'）、ページ、1 ページあたりの結果数で任意に絞り込めます。動画 ID や URL などのメタデータと、現在の API レート制限状況を返します。
• getPopularVideos：Pexels の人気動画一覧を取得します。寸法、長さ、ページ、1 ページあたりの結果数で任意に絞り込めます。
• getVideo：ID で指定した動画の詳細情報を取得します。
• downloadVideo：ID と希望する画質（hd/sd）を指定して動画を取得します。直接ダウンロードリンク、推奨ファイル名、帰属表示情報を返します。AI クライアントは、利用可能なローカルツール（curl や PowerShell の Invoke-WebRequest など）を使用して、提供されたリンクから動画をダウンロードしてください。

コレクションツール

• getFeaturedCollections：注目のコレクション一覧を取得します。ページネーションも任意で指定できます。
• getMyCollections：（コード内でコメントアウトされています）OAuth 2.0 認証が必要ですが、このサーバーではサポートされていません。
• getCollectionMedia：コレクション ID で指定したコレクションからメディア項目（写真または動画）を取得します。種類、並べ替え順、ページ、1 ページあたりの結果数で任意に絞り込めます。

リソース

サーバーは、URI で指定できる以下のリソースを提供します。

• `pexels-photo://{id}：ID で特定の写真にアクセスします
• `pexels-video://{id}：ID で特定の動画にアクセスします
• `pexels-collection://{id}：ID で特定のコレクションにアクセスします

エラー処理

サーバーは、API キーが無効な場合、レート制限に達した場合、リソースが見つからない場合など、よくある問題について有用なエラーメッセージを提供するよう努めています。成功時のレスポンスにも、現在の Pexels API のレート制限状況（残りのリクエスト数、リセット時刻）が出力に含まれます。

帰属表示の要件

Pexels API を使用する際は、以下の帰属表示要件に従う必要があります。

• Pexels への目立つリンクを必ず表示してください（例：「写真提供：Pexels」）
• 写真家のクレジットを必ず表示してください（例：「Pexels の John Doe による写真」）

ライセンス

ISC