pixabay-mcp

The pixabay-mcp is an MCP server designed for accessing the Pixabay image search API. Built with TypeScript, it offers tools for searching images, formatting results, and handling errors. Developers can easily search for images on Pixabay and retrieve results.

GitHub

GitHub Stars

User Rating

Not Rated

Favorites

Views

Forks

Issues

README

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:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

Set up your Pixabay API key as an environment variable:

# On Windows
set PIXABAY_API_KEY=your_api_key_here

# On macOS/Linux
export PIXABAY_API_KEY=your_api_key_here

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

{
  "mcpServers": {
    "pixabay-mcp": {
      "command": "/path/to/pixabay-mcp/build/index.js",
      "env": {
        "PIXABAY_API_KEY": "your_api_key_here"
      }
    }
  }
}