
pixabay-mcp MCP Server

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
安装教程
- 设置 Pixabay API 密钥作为环境变量:
# Windows
set PIXABAY_API_KEY=your_api_key_here
# macOS/Linux
export PIXABAY_API_KEY=your_api_key_here
- 与 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,用于在浏览器中访问调试工具。