Pixabay-MCP 服务端

英文版

一个基于Pixabay图片搜索的 Model Context Protocol (MCP) 服务器。

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