What is Qiniu MCP Server

The Qiniu Cloud Storage MCP service provides a streamlined way to upload files to Qiniu Cloud Storage. It leverages a Python-based server to facilitate interactions with the storage service, enabling easy file uploads and management.

Use cases

This service is suitable for applications that require file storage and retrieval, such as web applications, mobile apps, or media platforms. It can handle uploads of various file types including images, videos, and documents, making it versatile for different digital content needs.

How to use

To use the MCP service, clone the repository, set up a virtual environment, install the necessary dependencies, and configure the environment variables with your Qiniu access credentials. Once everything is set up, you can start the service with a Python command and use the provided client interface to upload files.

Key features

Key features include a simple file upload interface, the ability to return public URLs for uploaded files, and easy integration with other systems. The service is designed for scalability and ease of use, allowing developers to focus on application development without worrying about backend file handling.

Where to use

This service can be used in any development environment that supports Python. It’s particularly beneficial in projects where cloud storage integration is required, allowing developers to offload file management to Qiniu Cloud while ensuring accessibility and storage efficiency.

七牛云存储 MCP 服务

用于上传文件到七牛云存储的MCP服务

安装指南

1. 克隆仓库
2. 创建并激活虚拟环境:

   python3 -m venv venv
   source venv/bin/activate
   

3. 安装依赖:

   pip install -r requirements.txt
   

4. 配置环境变量:

   export QINIU_ACCESS_KEY="你的AccessKey"
   export QINIU_SECRET_KEY="你的SecretKey" 
   export QINIU_BUCKET_NAME="joemarkdown"
   export QINIU_DOMAIN="https://img.t5t6.com"
   

5. 启动服务:

   python server.py
   

配置说明

1. 复制示例配置文件:

   cp .env.example .env
   

2. 编辑.env文件填写你的七牛云凭证
3. 切勿将.env文件提交到版本控制

示例.env内容:

QINIU_ACCESS_KEY=你的AccessKey
QINIU_SECRET_KEY=你的SecretKey
QINIU_BUCKET_NAME=你的存储空间名称
QINIU_DOMAIN=https://你的域名

使用方法

1. 克隆项目后首次运行:

# 进入项目目录
cd qiniu_mcp_server

# 创建虚拟环境
python3 -m venv venv

# 激活环境 (Linux/Mac)
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 复制并配置.env文件
cp .env.example .env
nano .env  # 编辑填入你的七牛云凭证

# 启动服务
python server.py

2. 日常使用:

cd qiniu_mcp_server
source venv/bin/activate  # 激活环境
python server.py          # 启动服务

3. 调用上传接口示例:

from mcp import McpClient

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

服务提供以下工具:

• upload_file(file_path: str) -> str: 上传文件并返回公开访问URL

Trae 集成配置

在Trae的配置文件中添加以下内容(请替换实际路径和凭证):

{
  "mcpServers": {
    "qiniu_mcp": {
      "command": "python",
      "args": [
        "/path/to/qiniu_mcp_server/server.py"
      ],
      "env": {
        "QINIU_ACCESS_KEY": "你的AccessKey",
        "QINIU_SECRET_KEY": "你的SecretKey",
        "QINIU_BUCKET_NAME": "你的存储空间名称",
        "QINIU_DOMAIN": "https://你的域名"
      }
    }
  }
}

注意: 实际使用时请确保:

1. 替换/path/to/为实际服务器路径
2. 使用真实的凭证信息替换示例值
3. 妥善保管凭证信息