pixabay-mcp MCP 服务器

English

一个用于 Pixabay 图片搜索的模型上下文协议服务器

这是一个基于 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

安装

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 以访问浏览器中的调试工具。