Pixabay

🚀 Pixabay - MCP 服务端

一个基于Pixabay图片搜索的 Model Context Protocol (MCP) 服务器，借助该服务端，用户能够便捷地访问Pixabay图片API，实现图片搜索等功能。

英文版

这是一个基于TypeScript的MCP服务器，提供访问Pixabay图片API的功能。它通过以下方式演示了核心MCP概念：

• 作为搜索Pixabay图片的工具。
• 提供带有图片URL和元数据的格式化结果。
• 具备处理API请求错误的能力。

🚀 快速开始

Pixabay - MCP服务端是一个强大的工具，可帮助你轻松访问Pixabay图片API。在使用前，你需要完成一系列的配置与安装步骤。

✨ 主要特性

工具

• search_pixabay_images：用于在Pixabay上搜索图片。
  • 必需参数：一个搜索查询。
  • 可选参数：包括图片类型、方向和每页结果数。
  • 返回结果：带URL的格式化图片结果列表。

配置

• 需要将Pixabay API密钥设置为环境变量 PIXABAY_API_KEY。
• 默认启用安全搜索。
• 具备处理API问题和无效参数的错误处理机制。

📦 安装指南

开发环境依赖安装

安装项目所需的依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式（带自动重建功能）

npm run watch

正式安装步骤

1. 设置Pixabay API密钥为环境变量：

# 在Windows上
set PIXABAY_API_KEY=your_api_key_here

# 在macOS/Linux上
export PIXABAY_API_KEY=your_api_key_here

2. 与Claude Desktop一起使用，添加服务器配置： 在MacOS上：~/Library/Application Support/Claude/claude_desktop_config.json 在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"
      }
    }
  }
}

调试说明

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们推荐使用MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector将提供一个访问浏览器中的调试工具的URL。