Provides comprehensive tools for managing Volcengine TOS (Object Storage) including bucket operations, object upload/download, presigned URL generation, and media processing capabilities like image processing and video snapshots.
火山引擎 对象存储 TOS 非官方 MCP工具
TOS 非官方 MCP 工具
快速开始
macOS 从零开始配置
1. 安装必要依赖
2. 方式一:直接从 GitHub 使用(推荐,无需克隆)
使用 uvx 可以直接从 GitHub 运行,无需克隆仓库:
3. 方式二:克隆到本地使用
如果需要修改代码或本地开发:
环境变量配置
复制环境变量模板:
编辑 .env
文件并填入配置,或者设置环境变量:
MCP 配置
方式一:直接从 GitHub 安装(推荐,无需克隆仓库)
Cline 或其他 MCP 客户端的配置文件中添加:
环境变量配置说明
TOS_ACCESS_KEY
: 火山引擎访问密钥 IDTOS_SECRET_KEY
: 火山引擎访问密钥 SecretTOS_REGION
: TOS 服务区域(如 cn-beijing)TOS_ENDPOINT
: TOS 服务端点(可选,如果不设置会根据 region 自动生成)
API 测试状态
API 名称 | 功能描述 | 分类 | 测试状态 | 测试环境 | 备注 |
| 创建存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
| 列举存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
| 获取存储桶元数据 | 桶管理 | ✅ 已测试 | Cline | - |
| 删除存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
| 上传对象 | 对象管理 | ✅ 已测试 | Cline | - |
| 下载对象 | 对象管理 | ✅ 已测试 | Cline | - |
| 列举对象 | 对象管理 | ✅ 已测试 | Cline | - |
| 删除对象 | 对象管理 | ✅ 已测试 | Cline | - |
| 生成预签名URL | 预签名 | ✅ 已测试 | Cline | - |
| 基础图片处理 | 图片处理 | ✅ 已测试 | Cline | 回写,并提供 URL 下载 |
| 获取图片信息 | 图片处理 | ✅ 已测试 | Cline | - |
| 视频截帧 | 视频处理 | ✅ 已测试 | Cline | - |
| 获取视频信息 | 视频处理 | ✅ 已测试 | Cline | 回写,并提供 URL 下载 |
测试图片
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
Appendix
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables interaction with Volcengine's TOS (Object Storage) service through MCP protocol. Supports bucket management, object operations, pre-signed URLs, and media processing including image manipulation and video frame extraction.
Related MCP Servers
- -securityFlicense-qualityThis server provides a standardized framework using the Model Context Protocol (MCP) to seamlessly integrate and manage diverse tools, enabling features like Twitter automation, cryptocurrency updates, and ElizaOS interaction.Last updated -2
- -securityAlicense-qualityThis server implements the Model Context Protocol (MCP) to handle asynchronous tasks with real-time status tracking, robust error handling, and automatic resource management.
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.Last updated -31MIT License
- AsecurityFlicenseAqualityA server based on MCP protocol that allows large language models to directly access Tencent Cloud Object Storage (COS) and Cloud Infinite (CI) services without coding, enabling file storage, retrieval, and processing operations.Last updated -185217