Pixabay

🚀 Pixabay - MCP 服務端

Pixabay - MCP 服務端是一個基於 Pixabay 圖片搜索的 Model Context Protocol (MCP) 服務器，它藉助 TypeScript 構建，為用戶提供訪問 Pixabay 圖片 API 的功能，能有效解決圖片搜索及結果格式化展示等問題，為開發者和用戶帶來便捷的圖片搜索體驗。

英文版

🚀 快速開始

這是一個基於 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

設置 API 密鑰

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。