Qiniu Cloud Storage

🚀 Qiniu Cloud Storage MCP Service

This is an MCP service used to upload files to Qiniu Cloud Storage.

🚀 Quick Start

✨ Features

• Provide a simple and efficient way to upload files to Qiniu Cloud Storage.
• Support configuration through environment variables and .env files.
• Integrate with Trae for easy use in other projects.

📦 Installation

1. Clone the repository.
2. Create and activate a virtual environment:

   python3 -m venv venv
   source venv/bin/activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Configure environment variables:

   export QINIU_ACCESS_KEY="YourAccessKey"
   export QINIU_SECRET_KEY="YourSecretKey" 
   export QINIU_BUCKET_NAME="joemarkdown"
   export QINIU_DOMAIN="https://img.t5t6.com"
   

5. Start the service:

   python server.py
   

📚 Documentation

Configuration Instructions

1. Copy the example configuration file:

   cp .env.example .env
   

2. Edit the .env file and fill in your Qiniu Cloud credentials.
3. Do not commit the .env file to version control.

Example .env content:

QINIU_ACCESS_KEY=YourAccessKey
QINIU_SECRET_KEY=YourSecretKey
QINIU_BUCKET_NAME=YourBucketName
QINIU_DOMAIN=https://YourDomain

💻 Usage Examples

Basic Usage

1. First run after cloning the project:

# Enter the project directory
cd qiniu_mcp_server

# Create a virtual environment
python3 -m venv venv

# Activate the environment (Linux/Mac)
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Copy and configure the .env file
cp .env.example .env
nano .env  # Edit and fill in your Qiniu Cloud credentials

# Start the service
python server.py

2. Daily use:

cd qiniu_mcp_server
source venv/bin/activate  # Activate the environment
python server.py          # Start the service

Advanced Usage

3. Example of calling the upload interface:

from mcp import McpClient

client = McpClient("qiniu_mcp")
url = client.use_tool("upload_file", {
    "file_path": "/path/to/your/file.jpg"
})
print("File URL:", url)

The service provides the following tools:

• upload_file(file_path: str) -> str: Upload a file and return a publicly accessible URL.

🔧 Trae Integration Configuration

Add the following content to the Trae configuration file (please replace the actual path and credentials):

{
  "mcpServers": {
    "qiniu_mcp": {
      "command": "python",
      "args": [
        "/path/to/qiniu_mcp_server/server.py"
      ],
      "env": {
        "QINIU_ACCESS_KEY": "YourAccessKey",
        "QINIU_SECRET_KEY": "YourSecretKey",
        "QINIU_BUCKET_NAME": "YourBucketName",
        "QINIU_DOMAIN": "https://YourDomain"
      }
    }
  }
}

⚠️ Important Note

When using it in practice, please ensure:

1. Replace /path/to/ with the actual server path.
2. Replace the example values with real credential information.
3. Keep the credential information properly.