mcp-server-pexels

An MCP (Model Context Protocol) server for the Pexels API. Built in Rust, exposes photo search, video search, and curated/featured content as MCP tools.

Communicates via stdio using JSON-RPC 2.0.

Tools

Tool	Description
`search_photos`	Search photos by query with optional orientation/size/color/locale filters
`curated_photos`	Get a paginated list of curated, hand-picked photos
`get_photo`	Retrieve a single photo by ID
`search_videos`	Search videos by query with optional orientation/size/locale filters
`popular_videos`	Get popular videos with optional dimension and duration filters
`get_video`	Retrieve a single video by ID
`featured_collections`	List featured collections (themed sets of media)
`collection_media`	List media in a specific collection (filterable by photos/videos)

Prerequisites

Rust (edition 2024)
A Pexels API key from pexels.com/api

Setup

bash

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

Create ~/.config/mcp-server-pexels/config.toml:

toml

api_key = "your-pexels-api-key"

Build

bash

cargo build --release

Produces target/release/mcp-server-pexels.

MCP configuration

config.json

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

Project structure

Code

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

License

MIT