pixabay-mcp MCP Server

pixabay-mcp MCP Server

site icon
2025.03.26 2
JavaScript图片搜索API 集成内容生成
pixabay-mcp 是一个基于 TypeScript 的 MCP 服务器,提供对 Pixabay 图片 API 的访问。它通过提供 Pixabay 图片搜索工具、格式化结果和 API 请求的错误处理,展示了核心 MCP 概念。
View on GitHub

Overview

基本能力

产品定位

pixabay-mcp 是一个用于 Pixabay 图片搜索的 MCP 服务器,旨在提供高效的图片搜索和获取服务。

核心功能

  • 图片搜索工具:提供 search_pixabay_images 工具,用于在 Pixabay 上搜索图片。
  • 必须参数:搜索查询
  • 可选参数:图片类型、方向和每页结果数
  • 返回格式化的图片结果列表,包含 URL 和元数据
  • 配置管理
  • 需要设置 Pixabay API 密钥作为环境变量 PIXABAY_API_KEY
  • 默认启用安全搜索
  • 提供 API 问题和无效参数的错误处理

适用场景

  • 需要集成 Pixabay 图片搜索功能的应用程序
  • 开发需要图片资源的项目
  • 快速获取高质量图片的场景

工具列表

  • search_pixabay_images:搜索 Pixabay 上的图片,返回包含 URL 和元数据的格式化结果。

常见问题解答

  • 如何调试 MCP 服务器? 由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

安装依赖项:

npm install

安装教程

  1. 设置 Pixabay API 密钥作为环境变量:
# Windows
set PIXABAY_API_KEY=your_api_key_here

# macOS/Linux
export PIXABAY_API_KEY=your_api_key_here
  1. 与 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 Inspector 进行调试:

npm run inspector

Inspector 将提供一个 URL,用于在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。