pexels

mcp-server-pexels

Pexels API 用の MCP（Model Context Protocol）サーバーです。Rust で構築されており、写真検索、動画検索、厳選・注目コンテンツを MCP ツールとして提供します。

stdio を介して JSON-RPC 2.0 で通信します。

ツール

ツール	説明
search_photos	クエリで写真を検索します。向き／サイズ／色／ロケールによる任意のフィルターを指定できます
curated_photos	ページ分けされた、厳選写真のリストを取得します
get_photo	ID を指定して写真を 1 枚取得します
search_videos	クエリで動画を検索します。向き／サイズ／ロケールによる任意のフィルターを指定できます
popular_videos	任意の寸法フィルターと再生時間フィルターを指定して、人気の動画を取得します
get_video	ID を指定して動画を 1 本取得します
featured_collections	注目のコレクション（テーマ別のメディアセット）を一覧表示します
collection_media	特定のコレクション内のメディアを一覧表示します（写真／動画でフィルター可能）

前提条件

• Rust（edition 2024）
• pexels.com/api から取得した Pexels API キー

セットアップ

mkdir -p ~/.config/mcp-server-pexels

~/.config/mcp-server-pexels/config.toml を作成します。

api_key = "your-pexels-api-key"

ビルド

cargo build --release

target/release/mcp-server-pexels が生成されます。

MCP の設定

{
  "mcpServers": {
    "pexels": {
      "command": "/path/to/mcp-server-pexels"
    }
  }
}

プロジェクト構成

src/
  main.rs    - entry point, config loading, stdio transport
  server.rs  - MCP tool definitions
  api.rs     - Pexels HTTP client and response types
  params.rs  - tool parameter types
  config.rs  - TOML config loading

ライセンス

MIT