七牛云存储 MCP 服务
用于上传文件到七牛云存储的MCP服务
安装指南
- 克隆仓库
- 创建并激活虚拟环境:
python3 -m venv venv source venv/bin/activate - 安装依赖:
pip install -r requirements.txt - 配置环境变量:
export QINIU_ACCESS_KEY="你的AccessKey" export QINIU_SECRET_KEY="你的SecretKey" export QINIU_BUCKET_NAME="joemarkdown" export QINIU_DOMAIN="https://img.t5t6.com" - 启动服务:
python server.py
配置说明
- 复制示例配置文件:
cp .env.example .env - 编辑
.env文件填写你的七牛云凭证 - 切勿将
.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://你的域名"
}
}
}
}
注意: 实际使用时请确保:
- 替换
/path/to/为实际服务器路径 - 使用真实的凭证信息替换示例值
- 妥善保管凭证信息