MCP Pixabay Server

🚀 MCP Pixabay 服務器

MCP Pixabay 服務器是基於 MCP 協議的 Pixabay API 接口服務器，能提供圖像和視頻資源的搜索功能，完全符合 MCP 規範，為用戶提供高質量服務。

🚀 快速開始

安裝

方法一：使用 npm 安裝

您可以使用以下命令通過 npm 安裝項目：

npm install mcp-pixabay-server

方法二：手動安裝

1. 克隆本倉庫到本地：

   git clone https://github.com/yourusername/mcp-pixabay-server.git
   

2. 進入項目目錄：

   cd mcp-pixabay-server
   

3. 安裝依賴項：

   npm install
   

配置

1. 創建一個配置文件 config.json，並添加以下內容：

   {
     "apiKey": "your_pixabay_api_key",
     "baseUrl": "https://pixabay.com/api/"
   }
   

2. 將 API 密鑰替換為您的 Pixabay 賬戶密鑰。

啟動服務器

在項目根目錄下運行以下命令啟動服務器：

node index.js

通過 CLI 調用

使用以下命令調用服務：

mcp-pixabay-server --query "貓" --category images

✨ 主要特性

• 圖片搜索：支持通過關鍵詞和過濾條件搜索圖片。
• 視頻搜索：支持通過關鍵詞和過濾條件搜索視頻。
• 自定義分類：允許用戶根據需求創建自定義分類。
• 多語言支持：支持多種語言的查詢和響應。

💻 使用示例

基礎用法

const { Client } = require('mcp-client');

async function main() {
  const client = new Client('localhost:3000');
  const response = await client.search('狗', 'images');
  console.log(response);
}

main();

📚 詳細文檔

項目結構

mcp-pixabay-server/
├── index.js              # 入口文件
├── config.json           # 配置文件
└── package.json          # 依賴管理

貢獻流程

1. Fork 倉庫並克隆到本地。
2. 創建功能分支：git checkout -b feature/your-feature
3. 提交代碼：git commit -m "feat: 添加新功能"
4. 推送分支：git push origin feature/your-feature
5. 提交 Pull Request。

貢獻規範

• 提交信息需遵循 Conventional Commits 規範。
• 每個 PR 必須通過所有測試和代碼檢查。

貢獻指南

歡迎任何形式的貢獻！請按照以下規範提交 Issue 和 Pull Request：

1. Issue：描述問題或功能需求，提供復現步驟和環境信息。
2. Pull Request：確保代碼通過測試，並遵循提交規範。

📄 許可證

本項目基於 MIT 許可證開源。具體許可內容請參閱 LICENSE 文件。