Pexels MCP

mcp-server-pexels

Um servidor MCP (Model Context Protocol) para a API do Pexels. Construído em Rust, expõe busca de fotos, busca de vídeos e conteúdo curado/destacado como ferramentas MCP.

Comunica-se via stdio usando JSON-RPC 2.0.

Ferramentas

Ferramenta	Descrição
search_photos	Busca fotos por consulta com filtros opcionais de orientação/tamanho/cor/localidade
curated_photos	Obtém uma lista paginada de fotos curadas e selecionadas manualmente
get_photo	Recupera uma única foto por ID
search_videos	Busca vídeos por consulta com filtros opcionais de orientação/tamanho/localidade
popular_videos	Obtém vídeos populares com filtros opcionais de dimensão e duração
get_video	Recupera um único vídeo por ID
featured_collections	Lista coleções em destaque (conjuntos temáticos de mídia)
collection_media	Lista mídia em uma coleção específica (filtrável por fotos/vídeos)

Pré-requisitos

• Rust (edição 2024)
• Uma chave de API do Pexels em pexels.com/api

Configuração

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

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

api_key = "your-pexels-api-key"

Compilação

cargo build --release

Produz target/release/mcp-server-pexels.

Configuração do MCP

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

Estrutura do projeto

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

Licença

MIT