Qiniu Cloud Storage

🚀 七牛云存储 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://你的域名

💻 使用示例

基础用法

克隆项目后首次运行

# 进入项目目录
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

日常使用

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

高级用法

调用上传接口示例

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. 妥善保管凭证信息。