Pexels MCP

mcp-server-pexels

Un servidor MCP (Model Context Protocol) para la API de Pexels. Construido en Rust, expone búsqueda de fotos, búsqueda de videos y contenido curado/destacado como herramientas MCP.

Se comunica a través de stdio usando JSON-RPC 2.0.

Herramientas

Herramienta	Descripción
search_photos	Buscar fotos por consulta con filtros opcionales de orientación/tamaño/color/idioma
curated_photos	Obtener una lista paginada de fotos curadas y seleccionadas manualmente
get_photo	Recuperar una sola foto por ID
search_videos	Buscar videos por consulta con filtros opcionales de orientación/tamaño/idioma
popular_videos	Obtener videos populares con filtros opcionales de dimensión y duración
get_video	Recuperar un solo video por ID
featured_collections	Listar colecciones destacadas (conjuntos temáticos de medios)
collection_media	Listar medios en una colección específica (filtrable por fotos/videos)

Requisitos previos

• Rust (edition 2024)
• Una clave de API de Pexels de pexels.com/api

Configuración

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

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

api_key = "your-pexels-api-key"

Compilación

cargo build --release

Produce target/release/mcp-server-pexels.

Configuración de MCP

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

Estructura del proyecto

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

Licencia

MIT