MCP Pixabay Server

🚀 MCP Pixabay サーバー

MCP Pixabay サーバーは、MCP プロトコルに基づく Pixabay API インターフェースサーバーです。画像とビデオリソースの検索機能を提供することを目的としています。このプロジェクトは完全に MCP 規格に準拠しており、ユーザーに高品質なサービスを提供することに取り組んでいます。

🚀 クイックスタート

MCP Pixabay サーバーを使用することで、Pixabay API を通じて画像やビデオの検索が可能になります。以下の手順でサーバーをセットアップして使用しましょう。

✨ 主な機能

• 画像検索：キーワードとフィルタ条件を使った画像検索をサポートします。
• ビデオ検索：キーワードとフィルタ条件を使ったビデオ検索をサポートします。
• カスタム分類：ユーザーが必要に応じてカスタム分類を作成できます。
• 多言語対応：複数の言語でのクエリとレスポンスをサポートします。

📦 インストール

方法一：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

コード例

以下は、MCP プロトコルを使用してサーバーを呼び出す例です。

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 規格に従ってください。
• 各 Pull Request はすべてのテストとコードチェックを通過する必要があります。

貢献ガイド

どんな形の貢献も歓迎します！以下の規則に従って Issue と Pull Request を提出してください。

1. Issue：問題や機能要求を説明し、再現手順と環境情報を提供してください。
2. Pull Request：コードがテストを通過し、コミット規則に従っていることを確認してください。

📄 ライセンス

このプロジェクトは MIT ライセンスのもとでオープンソース化されています。詳細なライセンス内容は LICENSE ファイルを参照してください。