Pixabay MCP Server

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

1. Set up your Pixabay API key as an environment variable:

2. 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.