Pixabay MCP Server

Busca y recupera imágenes y videos libres de derechos usando la API de Pixabay.

Documentación

Pixabay MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API de Pixabay para buscar y recuperar imágenes y videos libres de regalías.

📖 Guía completa de configuración y uso - Tutorial paso a paso con ejemplos y solución de problemas

Características

Búsqueda de imágenes: Busca entre millones de imágenes libres de regalías
Búsqueda de videos: Encuentra videos de stock de alta calidad
Filtrado avanzado: Filtra por categoría, orientación, color, tamaño y más
Consulta individual: Obtén imágenes o videos específicos por ID
Múltiples formatos: Accede a diferentes tamaños de imagen y calidades de video

Instalación

Clona este repositorio:

git clone <your-repo-url>
cd pixabay-mcp-server

Instala las dependencias:

npm install

Compila el proyecto:

npm run build

Configuración

Configuración de la clave de API

Necesitarás una clave de API de Pixabay para usar este servidor:

Regístrate en Pixabay
Ve a la página de API de Pixabay
Obtén tu clave de API
Establece la variable de entorno del sistema (recomendado por seguridad):

Para bash/zsh (agrega a ~/.bashrc, ~/.zshrc o ~/.bash_profile):

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

Para fish (agrega a ~/.config/fish/config.fish):

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

Para Windows (Símbolo del sistema):

setx PIXABAY_API_KEY "your-api-key-here"

Después de establecer la variable de entorno, reinicia tu terminal o ejecuta:

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

Configuración de Claude Desktop

Agrega el servidor a tu archivo de configuración de Claude Desktop:

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

Recomendado (usando la variable de entorno del sistema):

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

Alternativa (menos segura - clave de API en el archivo de configuración):

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

Nota de seguridad: El enfoque recomendado usa tu variable de entorno del sistema, manteniendo la clave de API fuera de los archivos de configuración.

Herramientas disponibles

search_images

Busca imágenes libres de regalías con varios filtros:

q: Término de búsqueda (máximo 100 caracteres)
lang: Código de idioma (predeterminado: "en")
image_type: "all", "photo", "illustration", "vector"
orientation: "all", "horizontal", "vertical"
category: Filtro de categoría (naturaleza, negocios, etc.)
min_width/min_height: Dimensiones mínimas
colors: Filtro de color (rojo, azul, escala de grises, etc.)
editors_choice: Solo premios de Editor's Choice
safesearch: Apto para todas las edades
order: "popular" o "latest"
page: Número de página (predeterminado: 1)
per_page: Resultados por página (3-200, predeterminado: 20)

search_videos

Busca videos libres de regalías con opciones de filtrado similares:

q: Término de búsqueda
video_type: "all", "film", "animation"
Todos los demás parámetros similares a la búsqueda de imágenes

get_image_by_id

Recupera una imagen específica por su ID de Pixabay:

id: ID de imagen de Pixabay (obligatorio)

get_video_by_id

Recupera un video específico por su ID de Pixabay:

id: ID de video de Pixabay (obligatorio)

Ejemplos de uso

Búsqueda básica de imágenes

Search for "mountain landscape" photos

Búsqueda avanzada de imágenes

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

Búsqueda de videos

Find animation videos about "space exploration"

Límites de velocidad de la API

100 solicitudes por 60 segundos de forma predeterminada
Las respuestas deben almacenarse en caché durante 24 horas
No se permiten descargas masivas sistemáticas

Formato de respuesta

El servidor devuelve respuestas JSON con metadatos de imágenes/videos que incluyen:

URLs para diferentes tamaños
Dimensiones y tamaños de archivo
Conteos de vistas/descargas/me gusta
Información del usuario
Etiquetas y categorías

Desarrollo

Ejecutar en modo de desarrollo

npm run dev

Compilar

npm run build

Pruebas

npm test

Contribuciones

Haz un fork del repositorio
Crea una rama de características
Realiza tus cambios
Agrega pruebas si corresponde
Envía una solicitud de extracción (pull request)

Autor

Creado por UnlockMCP - Tu guía para dominar las implementaciones de Model Context Protocol.

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles

Aviso legal

Este servidor proporciona acceso a la API de Pixabay. Por favor, cumple con:

Los Términos de Servicio de Pixabay
Los requisitos de la Licencia de Contenido
Los requisitos de atribución al mostrar resultados de búsqueda
Los requisitos de límite de velocidad y almacenamiento en caché

Las imágenes y videos están sujetos a la Licencia de Contenido de Pixabay. Siempre verifica las licencias individuales de imágenes/videos antes de usarlos.