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