Pixabay MCP Server

Pesquise e recupere imagens e vídeos livres de royalties usando a API do Pixabay.

GitHub
10
Experimente este MCPPatrocinado

Documentação

Pixabay MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso à API do Pixabay para pesquisar e recuperar imagens e vídeos livres de royalties.

📖 Guia Completo de Configuração e Uso - Tutorial passo a passo com exemplos e solução de problemas

Recursos

  • Pesquisa de Imagens: Pesquise em milhões de imagens livres de royalties
  • Pesquisa de Vídeos: Encontre vídeos de banco de alta qualidade
  • Filtragem Avançada: Filtre por categoria, orientação, cor, tamanho e mais
  • Consulta Individual: Obtenha imagens ou vídeos específicos por ID
  • Múltiplos Formatos: Acesse diferentes tamanhos de imagem e qualidades de vídeo

Instalação

  1. Clone este repositório:
git clone <your-repo-url>
cd pixabay-mcp-server
  1. Instale as dependências:
npm install
  1. Compile o projeto:
npm run build

Configuração

Configuração da Chave de API

Você precisará de uma chave de API do Pixabay para usar este servidor:

  1. Cadastre-se no Pixabay
  2. Acesse a página da API do Pixabay
  3. Obtenha sua chave de API
  4. Defina a variável de ambiente do sistema (recomendado por segurança):

Para bash/zsh (adicione ao ~/.bashrc, ~/.zshrc ou ~/.bash_profile):

export PIXABAY_API_KEY="your-api-key-here"

Para fish (adicione ao ~/.config/fish/config.fish):

set -gx PIXABAY_API_KEY "your-api-key-here"

Para Windows (Prompt de Comando):

setx PIXABAY_API_KEY "your-api-key-here"

Após definir a variável de ambiente, reinicie seu terminal ou execute:

source ~/.zshrc  # or your shell's config file

Configuração do Claude Desktop

Adicione o servidor ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Recomendado (usando a variável de ambiente do sistema):

{
  "mcpServers": {
    "pixabay": {
      "command": "node",
      "args": ["/path/to/pixabay-mcp-server/dist/index.js"]
    }
  }
}

Alternativa (menos segura - chave de API no arquivo de configuração):

{
  "mcpServers": {
    "pixabay": {
      "command": "node",
      "args": ["/path/to/pixabay-mcp-server/dist/index.js"],
      "env": {
        "PIXABAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Nota de Segurança: A abordagem recomendada usa sua variável de ambiente do sistema, mantendo a chave de API fora dos arquivos de configuração.

Ferramentas Disponíveis

search_images

Pesquise imagens livres de royalties com vários filtros:

  • q: Termo de pesquisa (máx. 100 caracteres)
  • lang: Código do idioma (padrão: "en")
  • image_type: "all", "photo", "illustration", "vector"
  • orientation: "all", "horizontal", "vertical"
  • category: Filtro de categoria (natureza, negócios, etc.)
  • min_width/min_height: Dimensões mínimas
  • colors: Filtro de cor (vermelho, azul, escala de cinza, etc.)
  • editors_choice: Somente prêmios Editor's Choice
  • safesearch: Seguro para todas as idades
  • order: "popular" ou "latest"
  • page: Número da página (padrão: 1)
  • per_page: Resultados por página (3-200, padrão: 20)

search_videos

Pesquise vídeos livres de royalties com opções de filtragem semelhantes:

  • q: Termo de pesquisa
  • video_type: "all", "film", "animation"
  • Todos os outros parâmetros semelhantes à pesquisa de imagens

get_image_by_id

Recupere uma imagem específica pelo seu ID do Pixabay:

  • id: ID da imagem no Pixabay (obrigatório)

get_video_by_id

Recupere um vídeo específico pelo seu ID do Pixabay:

  • id: ID do vídeo no Pixabay (obrigatório)

Exemplos de Uso

Pesquisa Básica de Imagens

Search for "mountain landscape" photos

Pesquisa Avançada de Imagens

Search for horizontal nature photos with minimum width 1920px, editors choice only

Pesquisa de Vídeos

Find animation videos about "space exploration"

Limites de Taxa da API

  • 100 solicitações por 60 segundos por padrão
  • As respostas devem ser armazenadas em cache por 24 horas
  • Downloads em massa sistemáticos não são permitidos

Formato de Resposta

O servidor retorna respostas JSON com metadados de imagem/vídeo, incluindo:

  • URLs para diferentes tamanhos
  • Dimensões e tamanhos de arquivo
  • Contagens de visualizações/downloads/curtidas
  • Informações do usuário
  • Tags e categorias

Desenvolvimento

Executando em Modo de Desenvolvimento

npm run dev

Compilação

npm run build

Testes

npm test

Contribuição

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Adicione testes se aplicável
  5. Envie um pull request

Autor

Criado por UnlockMCP - Seu guia para dominar implementações do Model Context Protocol.

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes

Aviso Legal

Este servidor fornece acesso à API do Pixabay. Por favor, cumpra:

  • Os Termos de Serviço do Pixabay
  • Os requisitos da Licença de Conteúdo
  • Os requisitos de atribuição ao exibir resultados de pesquisa
  • Os requisitos de limite de taxa e cache

Imagens e vídeos estão sujeitos à Licença de Conteúdo do Pixabay. Sempre verifique as licenças individuais de imagens/vídeos antes de usar.