A
licenseD
qualityD
maintenanceA Model Context Protocol server that enables searching for similar images by text description, integrating Inspire's backend image search capabilities with LLM interfaces like Claude Desktop.
1
3
GPL 3.0
Pixabay MCP Server
by zym9863
Servidor MCP pixabay-mcp
Un servidor de protocolo de contexto modelo para la búsqueda de imágenes en Pixabay
Este es un servidor MCP basado en TypeScript que proporciona acceso a la API de imágenes de Pixabay. Demuestra los conceptos básicos de MCP al proporcionar:
Herramientas para buscar imágenes en Pixabay
Resultados formateados con URL de imágenes y metadatos
Manejo de errores para solicitudes de API
Características
Herramientas
search_pixabay_images- Buscar imágenes en PixabayToma una consulta de búsqueda como parámetro obligatorio
Parámetros opcionales para el tipo de imagen, la orientación y los resultados por página
Devuelve una lista formateada de resultados de imágenes con URL
Configuración
Requiere una clave API de Pixabay establecida como variable de entorno
PIXABAY_API_KEYBúsqueda segura habilitada de forma predeterminada
Manejo de errores para problemas de API y parámetros no válidos
Related MCP server: Lorem Ipsum MCP Server
Desarrollo
Instalar dependencias:
npm installConstruir el servidor:
npm run buildPara desarrollo con reconstrucción automática:
npm run watchInstalación
Configure su clave API de Pixabay como una variable de entorno:
# On Windows
set PIXABAY_API_KEY=your_api_key_here
# On macOS/Linux
export PIXABAY_API_KEY=your_api_key_herePara utilizar con Claude Desktop, agregue la configuración del servidor:
En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"pixabay-mcp": {
"command": "/path/to/pixabay-mcp/build/index.js",
"env": {
"PIXABAY_API_KEY": "your_api_key_here"
}
}
}
}Depuración
Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:
npm run inspectorEl Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.
Available Tools
2 toolssearch_pixabay_imagesC
Search for images on Pixabay
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query terms | |
| image_type | No | Filter results by image type | all |
| orientation | No | Filter results by image orientation | all |
| per_page | No | Number of results per page (3-200) |
TDQS
C2.9/5.0
Behavior2/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('Search for') but doesn't describe any behavioral traits such as rate limits, authentication needs, pagination behavior, or what the response looks like. For a search tool with zero annotation coverage, this leaves significant gaps in understanding how it operates.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's purpose without any unnecessary words. It's appropriately sized and front-loaded, making it easy to understand at a glance. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness2/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete for a search tool with 4 parameters. It doesn't cover behavioral aspects like response format, error handling, or usage constraints. While the schema handles parameters well, the overall context for proper tool invocation is insufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with all parameters well-documented in the schema itself. The description doesn't add any meaning beyond what the schema provides—it doesn't explain parameter interactions, default behaviors, or usage examples. This meets the baseline of 3 since the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Search for') and resource ('images on Pixabay'), making the purpose immediately understandable. It distinguishes from the sibling tool 'search_pixabay_videos' by specifying images, though it doesn't explicitly contrast them. The description is specific but lacks explicit sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines2/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention the sibling tool 'search_pixabay_videos' or any other potential alternatives, nor does it provide context about appropriate use cases or exclusions. The user must infer usage from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_pixabay_videosC
Search for videos on Pixabay
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query terms | |
| video_type | No | Filter results by video type | all |
| orientation | No | Filter results by video orientation | all |
| per_page | No | Number of results per page (3-200) | |
| min_duration | No | Minimum video duration in seconds | |
| max_duration | No | Maximum video duration in seconds |
TDQS
C2.9/5.0
Behavior2/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure but only states the basic action. It doesn't mention authentication requirements, rate limits, pagination behavior, error handling, or what the search results look like (e.g., format, fields). For a search tool with no annotations, this leaves significant gaps in understanding how it behaves.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with no wasted words, making it easy to parse and front-loaded with the core purpose. It's appropriately sized for a straightforward search tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness2/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (6 parameters, no annotations, no output schema), the description is incomplete. It lacks details on behavioral traits, output format, and usage context, making it insufficient for an agent to fully understand how to invoke and interpret results without relying heavily on the schema alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds no parameter-specific information beyond what's in the input schema, which has 100% coverage with detailed descriptions for all 6 parameters. Since the schema fully documents parameters, the baseline score of 3 is appropriate, as the description doesn't compensate but also doesn't detract.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Search for') and resource ('videos on Pixabay'), making the purpose immediately understandable. However, it doesn't explicitly differentiate from its sibling tool 'search_pixabay_images' beyond the resource type, which is implied but not stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines2/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, such as its sibling 'search_pixabay_images' for image searches. There's no mention of prerequisites, context, or exclusions, leaving usage entirely to inference from the tool name and parameters.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- Added
search_pixabay_videos
1 tool update
- First observed
search_pixabay_images
TDQS
B3.2/5.0
Scored across 2 tools
Disambiguation5/5
The two tools have perfectly distinct purposes: one searches for images and the other searches for videos on Pixabay. There is no overlap or ambiguity between them, making it trivial for an agent to choose the correct tool based on the desired media type.
Naming Consistency5/5
Both tools follow a consistent verb_noun pattern with 'search_pixabay_' as a prefix, followed by the media type ('images' or 'videos'). This naming convention is clear, predictable, and uniform across all tools in the set.
Tool Count3/5
With only two tools, the server feels thin for a media search domain, as it lacks operations for retrieving details, downloading, or managing favorites. However, it is reasonable for a minimal search-focused interface, though agents might need workarounds for extended functionality.
Completeness2/5
The tool set is severely incomplete for a Pixabay integration, covering only search operations. There are significant gaps, such as no tools for getting image/video details, downloading media, or handling user accounts, which limits agent workflows and could lead to failures in broader tasks.
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
MCP server for Pixapi: check live credit pricing and balance, then generate images and video.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Search and browse every MCP server in the Model Context Protocol registry.
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server that enables image generation and retrieval from picsum.photos with customizable parameters like dimensions, filters, and output formats.1-
- FlicenseBqualityDmaintenanceA Model Context Protocol server that provides access to the Pexels API for searching and retrieving photos, videos, and collections.823-
- AlicenseAqualityCmaintenanceA Model Context Protocol server that exposes Pexels API tools for searching and retrieving free stock photos, videos, and curated collections, enabling AI agents to incorporate royalty-free media directly from chat.291452MIT