🚀 Pixabay - MCP 服务端

Pixabay - MCP 服务端是一个基于 Pixabay 图片搜索的 Model Context Protocol (MCP) 服务器，它借助 TypeScript 构建，为用户提供访问 Pixabay 图片 API 的功能，能有效解决图片搜索及结果格式化展示等问题，为开发者和用户带来便捷的图片搜索体验。

英文版

🚀 快速开始

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

• 搜索 Pixabay 图片的工具
• 带有图片 URL 和元数据的格式化结果
• 处理 API 请求错误

✨ 主要特性

工具

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

配置

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

📦 安装指南

安装依赖

npm install

构建服务器

npm run build

带有自动重建功能的开发

npm run watch

设置 API 密钥

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。