io.github.codeChap/pexels
MCP server for Pexels — search photos and videos, and browse collections
Open source Open in the app JSON README (API)
About
MCP server for Pexels — search photos and videos, and browse collections
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- codechap
- Origin
- official
- Category
- ferramentas
- Transport
- desconhecido
- Version
- 0.1.0
- Last push
- 2026-08-26T15:47:19Z
- Repository state
- ativo
- Language
- Rust
- Added
- 2026-08-29 03:02:36
- Updated
- 2026-08-29 03:02:36
- Origin id
io.github.codeChap/pexels
README
# 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](https://www.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
```json
{
"mcpServers": {
"pexels": {
"command": "/path/to/mcp-server-pexels"
}
}
}
```
## Project structure
```
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