Tos MCP

🚀 火山引擎 對象存儲 TOS 非官方 MCP工具

本工具是火山引擎對象存儲 TOS 的非官方 MCP 工具，可幫助用戶更便捷地操作 TOS 相關功能。

🚀 快速開始

使用 uv（推薦，更好的可移植性）

安裝 uv

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆項目和安裝依賴

git clone <repository-url>
cd tos-mcp

# 自動安裝依賴
uv sync

運行服務器

# 直接運行（推薦）
uv run tos-mcp-server

# 或者通過模塊運行
uv run python -m tos_mcp_server

環境變量配置

複製環境變量模板：

cp .env.example .env

編輯 .env 文件並填入配置，或者設置環境變量：

export TOS_ACCESS_KEY="your_access_key"
export TOS_SECRET_KEY="your_secret_key"
export TOS_REGION="cn-beijing"
export TOS_ENDPOINT="https://tos-cn-beijing.volces.com"

⚙️ config 配置

使用uv方式（推薦）

或者如果項目在用戶目錄下：

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": ["run", "tos-mcp-server"],
      "cwd": "~/tos-mcp",
      "env": {
        "TOS_ACCESS_KEY": "your-access-key",
        "TOS_SECRET_KEY": "your-secret-key",
        "TOS_REGION": "cn-beijing", 
        "TOS_ENDPOINT": "https://tos-cn-beijing.volces.com"
      }
    }
  }
}

環境變量方式（.env文件）

如果你不想在配置中暴露敏感信息，可以使用.env文件：

1. 複製並配置環境變量：

cp .env.example .env
# 編輯.env文件填入你的配置

2. 簡化的MCP配置：

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": ["run", "tos-mcp-server"],
      "cwd": "~/tos-mcp"
    }
  }
}

🧪 API 測試狀態

🖼️ 測試圖片

Cline 配置測試

創建bucket

list bucket

刪除 bucket

獲取 bucket 元數據

生成預簽名 url

下載TOS文件 到本地

上傳本地文件 到TOS

列舉桶內對象

刪除文件

獲取圖片元信息

圖像處理，並回寫，生成 presign url

視頻截幀，並回寫，生成 presign url

📚 TOS 文檔

• Python SDK 簡介:https://www.volcengine.com/docs/6349/92785
• 安裝 Python SDK:https://www.volcengine.com/docs/6349/93479
• 初始化客戶端（Python SDK）:https://www.volcengine.com/docs/6349/93483
• 快速入門（Python SDK）:https://www.volcengine.com/docs/6349/92786
• 普通預簽名（Python SDK）:https://www.volcengine.com/docs/6349/135725
• 創建桶(PythonSDK):https://www.volcengine.com/docs/6349/92793
• 列舉桶(PythonSDK):https://www.volcengine.com/docs/6349/92794
• 獲取桶元數據(PythonSDK):https://www.volcengine.com/docs/6349/92795
• 刪除桶(PythonSDK):https://www.volcengine.com/docs/6349/92796
• 普通上傳（Python SDK）:https://www.volcengine.com/docs/6349/92800
• 普通下載（Python SDK）:https://www.volcengine.com/docs/6349/92803
• 列舉對象 V2（Python SDK）:https://www.volcengine.com/docs/6349/173820
• 刪除對象（Python SDK）:https://www.volcengine.com/docs/6349/92805
• 基礎圖片處理（Python SDK）:https://www.volcengine.com/docs/6349/1157332
• 獲取圖片信息（Python SDK）:https://www.volcengine.com/docs/6349/1157336
• 圖片處理持久化（Python SDK）:https://www.volcengine.com/docs/6349/1157338
• 視頻截幀（Python SDK）:https://www.volcengine.com/docs/6349/1157340
• 獲取視頻信息（Python SDK）:https://www.volcengine.com/docs/6349/1157341
• 獲取視頻信息（Python SDK）:https://www.volcengine.com/docs/6349/1157343