Documentation
TOS MCP Server
TOS 官方推出的 MCP Server 提供强大的查询能力，支持通过自然语言便捷地探索和检索 TOS 中存储的内容，提升了数据访问的直观性与效率。可以与火山引擎云产品
MCP 组合，助力构建更智能的业务应用场景。
| 版本 | v0.2.0 |
|---|---|
| 描述 | 基于 MCP 管理 TOS 资源，智能化探索数据 |
| 分类 | 存储 |
| 标签 | 搜索，视频，图片，文本 |
Tools
本 MCP Server 产品提供以下 Tools (工具/能力):
Tool 1: list_buckets
类型
SaaS
详细描述
该工具允许您便捷查看火山引擎TOS的存储桶列表。
调试所需的输入参数:
输入：
{
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"name": "list_buckets",
"description": "查询您账号下拥有的所有存储桶的列表。"
}输出：
- 返回您账号下拥有的存储桶列表，包含桶名、创建时间、桶位置信息、访问域名等信息。
最容易被唤起的 Prompt示例
列举火山引擎 TOS 的存储桶列表。Tool 2: list_objects
类型
SaaS
详细描述
该工具允许您便捷查看火山引擎TOS桶下的对象列表，每次请求都会返回存储桶中的部分或全部对象（最多 1000
个）。您可以使用请求参数作为选择条件，返回存储桶中对象的子集。
调试所需的输入参数:
输入：
{
"inputSchema": {
"type": "object",
"required": [
"bucket"
],
"properties": {
"bucket": {
"type": "string",
"description": "用户指定的存储桶名称"
},
"prefix": {
"type": "string",
"description": "可选的对象前缀"
},
"start_after": {
"type": "string",
"description": "列举对象的起始位置。您可以通过指定对象的起始位置分页列举对象"
},
"continuation_token": {
"type": "string",
"description": "指定列举操作从该 Token 开始，通常从上次请求返回的 NextContinuationToken 中获取此 Token"
}
}
},
"name": "list_objects",
"description": "查询您指定存储桶的对象列表"
}输出：
- 返回您指定存储下的对象列表，包含对象名、对象的最后修改时间、ETag、对象大小、存储类型等信息。
最容易被唤起的 Prompt示例
列举火山引擎 TOS 的 example 桶下的对象。Tool 3: get_object tool
类型
SaaS
详细描述
从 TOS 检索对象，需要指定桶名和对象的完整路径。对于文本内容的对象，比如文本文件、CSV
文件等，该工具返回的是其内容。对于图片、视频等二进制对象，该工具返回的是Base64编码的内容。
调试所需的输入参数:
输入：
{
"inputSchema": {
"type": "object",
"required": [
"bucket",
"key"
],
"properties": {
"bucket": {
"type": "string",
"description": "用户指定的存储桶名称"
},
"key": {
"type": "string",
"description": "用户需要读取的对象名，需要指定完整的对象名"
}
}
},
"name": "get_object",
"description": "获取指定对象的内容，对于文本内容的对象，比如文本文件、CSV 文件等，该工具返回的是其内容。对于图片、视频等二进制对象，该工具返回的是Base64编码的内容。"
}输出：
- 返回具体的对象内容，对于文本内容的对象，比如文本文件、CSV 文件等，该工具返回的是内容。对于图片、视频等二进制对象，该工具返回的是Base64编码的内容。
最容易被唤起的 Prompt示例
读取火山引擎 TOS 桶example下对象名为example.txt的文件内容可适配平台
方舟，python，cursor
服务开通链接 (整体产品)
鉴权方式
火山引擎，从 volcengine 管理控制台获取 volcengine 访问密钥 ID、秘密访问密钥和区域，请在.env文件中设置相关环境变量
环境变量
以下环境变量可用于配置MCP服务器:
| 环境变量 | 描述 | 默认值 |
|---|---|---|
VOLCENGINE_ACCESS_KEY | 火山引擎账号 ACCESS KEY | - |
VOLCENGINE_SECRET_KEY | 火山引擎账号 SECRET KEY | - |
VOLCENGINE_REGION | 火山引擎 TOS region | - |
TOS_ENDPOINT | 火山引擎 TOS Endpoint | - |
SECURITY_TOKEN | 火山引擎 Security Token，可选 | - |
TOS_BUCKETS | 指定访问的 TOS 桶，可选 | - |
安装部署
系统依赖
- 安装 Python 3.10 或者更高版本
- 安装 uv
- 如果是linux系统
curl -LsSf https://astral.sh/uv/install.sh | sh- 如果是window系统
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"- 同步依赖项并更uv.lock:
uv sync- 构建mcp server:
uv buildUsing uv (recommended)
When using [uv](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [uvx](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-tos*.
本地配置
添加以下配置到你的 mcp settings 文件中
{
"mcpServers": {
"tos-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_tos",
"run",
"mcp-server-tos"
]
}
}
}在不同平台的配置
方舟
体验中心
[示例如下]
1. 查看MCP Server 详情
在大模型生态广场，选择合适的MCP Server，并查看详情
2. 选择MCP Server即将运行的平台
检查当前MCP Server 已适配的平台，并选择合适的平台
3. 查看并对比可用的Tools
仔细查看可用的Tools的功能描述与所需的输入参数，并尝试运行对应的功能。
4. 获取专属的URL或代码示例
检查账号登录状态与服务开通情况，生成唯一URL
5. 去对应的Client的平台进行使用
点击快捷跳转按钮，前往方舟平台的体验中心进行对应MCP Server的体验
产品截图/视频 - optional
Cursor
部署
[示例如下]
UVX
{
"mcpServers": {
"tos-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_tos",
"mcp-server-tos"
],
"env": {
"VOLCENGINE_ACCESS_KEY": "your access-key-id",
"VOLCENGINE_SECRET_KEY": "your access-key-secret",
"VOLCENGINE_REGION": "tos region",
"TOS_ENDPOINT": "tos endpoint",
"SECURITY_TOKEN": "your security token",
"TOS_BUCKET": "your specific bucket"
}
}
}
}License
volcengine/mcp-server is licensed under the MIT License.
Similar MCP
Based on tags & features
Trending MCP
Most active this week