AI导哈

图片视频搜索服务

Pixabay MCP Server 是一个提供访问Pixabay API的服务，用于搜索和检索免版税的图片和视频，支持高级过滤和多格式访问。

  • by Unlock-MCP
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 Unlock-MCP/pixabay-mcp-server

使用说明

Pixabay MCP服务器

一种模型上下文协议（MCP）服务器，提供对Pixabay API的访问，用于搜索和检索无版税图像和视频。

📖 完整的设置和使用指南 -带示例和故障排除的分步教程

特性

  • 图像搜索：搜索数百万张免版税图片
  • 视频搜索：查找高质量的库存视频
  • 高级过滤：按类别、方向、颜色、大小等筛选
  • 个人查询：按ID获取特定图像或视频
  • 多种格式：访问不同的图像大小和视频质量

安装

  1. 克隆此存储库：
git clone <your-repo-url>
cd pixabay-mcp-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

配置

API密钥设置

您需要Pixabay API密钥才能使用此服务器：

  1. 注册地址： Pixabay
  2. 首选 Pixabay API页面
  3. 获取API密钥
  4. 设置系统环境变量 （出于安全考虑建议）：

对于bash/zsh （添加到~/.bashrc、~/.zshrc或~/.bash_profile）：

export PIXABAY_API_KEY="your-api-key-here"

对于鱼类 （添加到~/.config/fish/config.fish）：

set -gx PIXABAY_API_KEY "your-api-key-here"

对于Windows （命令提示符）：

setx PIXABAY_API_KEY "your-api-key-here"

设置环境变量后，重新启动终端或运行：

source ~/.zshrc  # or your shell's config file

Claude桌面配置

将服务器添加到Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

推荐（使用系统环境变量）：

{
  "mcpServers": {
    "pixabay": {
      "command": "node",
      "args": ["/path/to/pixabay-mcp-server/dist/index.js"]
    }
  }
}

替代（安全性较低-配置文件中的API密钥）：

{
  "mcpServers": {
    "pixabay": {
      "command": "node",
      "args": ["/path/to/pixabay-mcp-server/dist/index.js"],
      "env": {
        "PIXABAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

安全说明：推荐的方法使用您的系统环境变量，将API密钥排除在配置文件之外。

可用工具

搜索图片

使用各种滤镜搜索免版税图像：

  • q：搜索词（最多100个字符）
  • lang：语言代码（默认值：“en”）
  • image_type：“全部”、“照片”、“插图”、“矢量”
  • orientation：“全部”、“水平”、“垂直”
  • category：类别过滤器（性质、业务等）
  • min_width/min_height：最小尺寸
  • colors：滤色器（红、蓝、灰度等）
  • editors_choice：仅限编辑选择奖
  • safesearch：适合所有年龄段
  • order：“流行”或“最新”
  • page：页码（默认值：1）
  • per_page：每页结果数（3-200，默认值：20）

搜索_视频

搜索具有类似过滤选项的免版税视频：

  • q：搜索词
  • video_type：“全部”、“电影”、“动画”
  • 与图像搜索类似的所有其他参数

get_image_by_id

通过Pixabay ID检索特定图像：

  • id：Pixabay图像ID（必填）

获取_视频_ id

通过Pixabay ID检索特定视频：

  • id：Pixabay视频ID（必填）

使用示例

基本图像搜索

Search for "mountain landscape" photos

高级图像搜索

Search for horizontal nature photos with minimum width 1920px, editors choice only

视频搜索

Find animation videos about "space exploration"

API费率限制

  • 默认情况下每60秒100个请求
  • 响应必须缓存24小时
  • 不允许系统性大规模下载

响应格式

服务器返回JSON响应，其中包含图像/视频元数据，包括：

  • 不同大小的URL
  • 尺寸和文件大小
  • 查看/下载/点赞计数
  • 用户信息
  • 标签和类别

发展

以开发模式运行

npm run dev

建筑

npm run build

测试

npm test

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交拉取请求

作者

由...创建 解锁MCP -您掌握模型上下文协议实现的指南。

许可证

MIT许可证-有关详细信息，请参阅许可证文件

免责声明

此服务器提供对Pixabay的API的访问。请遵守：

  • Pixabay的服务条款
  • 内容许可证要求
  • 显示搜索结果时的归因要求
  • 速率限制和缓存要求

图片和视频受Pixabay内容许可证的约束。使用前务必检查单个图像/视频许可证。

相关 MCP