pixabay-mcp MCP 服务器

中文版

一个用于 Pixabay 图片搜索的 Model Context Protocol 服务器

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

• 用于在 Pixabay 上搜索图片的工具
• 包含图片 URL 和元数据的格式化结果
• 对 API 请求的错误处理

功能

工具

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

配置

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

开发

安装依赖：
bash
npm install

构建服务器：
bash
npm run build

开发时自动重建：
bash
npm run watch

安装

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

bash

在 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

json
{
"mcpServers": {
"pixabay-mcp": {
"command": "/path/to/pixabay-mcp/build/index.js",
"env": {
"PIXABAY_API_KEY": "your_api_key_here"
}
}
}
}

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会比较困难。我们推荐使用 MCP Inspector，它可以通过包脚本获得：

bash
npm run inspector

Inspector 会提供一个 URL，您可以在浏览器中访问调试工具。