The Pixabay MCP Server allows you to search for images on Pixabay via a Model Context Protocol server.
- Search Images: Search using the
search_pixabay_images
tool with a required query string - Filter Results: Customize by image type (photo, illustration, vector), orientation (horizontal, vertical), and results per page (3-200)
- Formatted Output: Receive structured results with image URLs and metadata
- Configuration: Configure with a Pixabay API key and enable safe search
- Error Handling: Built-in handling for API issues and invalid parameters
Provides tools for searching images on Pixabay, returning formatted results with image URLs and metadata, with options to filter by image type and orientation.
pixabay-mcp MCP Server
A Model Context Protocol server for Pixabay image search
This is a TypeScript-based MCP server that provides access to the Pixabay image API. It demonstrates core MCP concepts by providing:
- Tools for searching images on Pixabay
- Formatted results with image URLs and metadata
- Error handling for API requests
Features
Tools
search_pixabay_images
- Search for images on Pixabay- Takes a search query as required parameter
- Optional parameters for image type, orientation, and results per page
- Returns formatted list of image results with URLs
Configuration
- Requires a Pixabay API key set as environment variable
PIXABAY_API_KEY
- Safe search enabled by default
- Error handling for API issues and invalid parameters
Development
Install dependencies:
Build the server:
For development with auto-rebuild:
Installation
- Set up your Pixabay API key as an environment variable:
- To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables searching for images on Pixabay with query parameters and returns formatted results with image URLs and metadata.
Related MCP Servers
- AsecurityAlicenseAqualityModel Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.Last updated -127815JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.Last updated -3511TypeScriptMIT License
- -securityAlicense-qualityModel Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.Last updated -11MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables fetching and processing images from URLs, local file paths, and numpy arrays, returning them as base64-encoded strings with proper MIME types.Last updated -1PythonMIT License