🚀 火山引擎 对象存储 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
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文件：
- 复制并配置环境变量：
cp .env.example .env
# 编辑.env文件填入你的配置
- 简化的MCP配置：
{
"mcpServers": {
"tos-mcp-server": {
"command": "uv",
"args": ["run", "tos-mcp-server"],
"cwd": "~/tos-mcp"
}
}
}
🧪 API 测试状态
| 属性 | 详情 |
|---|---|
| API 名称 | 功能描述 |
| 分类 | 测试状态 |
| 测试环境 | 备注 |
| API 名称 | 功能描述 | 分类 | 测试状态 | 测试环境 | 备注 |
|---|---|---|---|---|---|
tos_create_bucket |
创建存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
tos_list_buckets |
列举存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
tos_get_bucket_meta |
获取存储桶元数据 | 桶管理 | ✅ 已测试 | Cline | - |
tos_delete_bucket |
删除存储桶 | 桶管理 | ✅ 已测试 | Cline | - |
tos_put_object |
上传对象 | 对象管理 | ✅ 已测试 | Cline | - |
tos_get_object |
下载对象 | 对象管理 | ✅ 已测试 | Cline | - |
tos_list_objects |
列举对象 | 对象管理 | ✅ 已测试 | Cline | - |
tos_delete_object |
删除对象 | 对象管理 | ✅ 已测试 | Cline | - |
tos_presigned_url |
生成预签名URL | 预签名 | ✅ 已测试 | Cline | - |
tos_image_process |
基础图片处理 | 图片处理 | ✅ 已测试 | Cline | 回写，并提供 URL 下载 |
tos_image_info |
获取图片信息 | 图片处理 | ✅ 已测试 | Cline | - |
tos_video_snapshot |
视频截帧 | 视频处理 | ✅ 已测试 | Cline | - |
tos_video_info |
获取视频信息 | 视频处理 | ✅ 已测试 | 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