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.jsonOn 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"
      }
    }
  }
}