MCP Pixabay Server

🚀 MCP Pixabay Server

The MCP Pixabay Server is a Pixabay API interface server based on the MCP protocol. It aims to provide search functionality for image and video resources. This project fully complies with the MCP specification and is committed to offering high - quality services to users.

🚀 Quick Start

To get started with the MCP Pixabay Server, you need to install and configure it first. Then you can start using its search services.

✨ Features

• Image Search: Supports searching for images by keywords and filter conditions.
• Video Search: Supports searching for videos by keywords and filter conditions.
• Custom Categories: Allows users to create custom categories according to their needs.
• Multilingual Support: Supports queries and responses in multiple languages.

📦 Installation

Method 1: Install via npm

You can install the project via npm using the following command:

npm install mcp-pixabay-server

Method 2: Manual Installation

1. Clone this repository to your local machine:

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

2. Navigate to the project directory:

   cd mcp-pixabay-server
   

3. Install the dependencies:

   npm install
   

📚 Documentation

Configuration

1. Create a configuration file config.json and add the following content:

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

2. Replace the API key with your Pixabay account key.

Usage

Start the Server

Run the following command in the project root directory to start the server:

node index.js

Invoke via CLI

Use the following command to call the service:

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

💻 Usage Examples

Basic Usage

Here is an example of using the MCP protocol to call the server:

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

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

main();

🔧 Technical Details

Project Structure

mcp-pixabay-server/
├── index.js              # Entry file
├── config.json           # Configuration file
└── package.json          # Dependency management

Contribution Process

1. Fork the repository and clone it to your local machine.
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your code: git commit -m "feat: 添加新功能"
4. Push the branch: git push origin feature/your-feature
5. Submit a Pull Request.

Contribution Guidelines

• Commit messages must follow the Conventional Commits specification.
• Each PR must pass all tests and code checks.

Contribution Guide

All forms of contributions are welcome! Please submit Issues and Pull Requests according to the following guidelines:

1. Issue: Describe the problem or feature request, and provide reproduction steps and environment information.
2. Pull Request: Ensure that the code passes the tests and follows the submission specifications.

📄 License

This project is open - sourced under the MIT license. Please refer to the LICENSE file for specific license details.