Qiniu Cloud Storage MCP 服务

用于上传文件到 Qiniu Cloud Storage 的 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 文件，填写你的 Qiniu Cloud 凭证
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. 保管好凭证信息