TOS MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TOS MCP Server list all objects in the 'documents' bucket"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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的文件内容Related MCP server: MinIO Storage MCP
可适配平台
方舟,python,cursor
服务开通链接 (整体产品)
https://console.volcengine.com/tos
鉴权方式
火山引擎,从 volcengine 管理控制台获取 volcengine 访问密钥 ID、秘密访问密钥和区域,请在.env文件中设置相关环境变量
环境变量
以下环境变量可用于配置MCP服务器:
环境变量 | 描述 | 默认值 |
| 火山引擎账号 ACCESS KEY | - |
| 火山引擎账号 SECRET KEY | - |
| 火山引擎 TOS region | - |
| 火山引擎 TOS Endpoint | - |
| 火山引擎 Security Token,可选 | - |
| 指定访问的 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 build
Using uv (recommended)
When using uv no specific installation is needed. We will
use uvx 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"
]
}
}
}在不同平台的配置
方舟
体验中心
[示例如下]
查看MCP Server 详情 在大模型生态广场,选择合适的MCP Server,并查看详情
选择MCP Server即将运行的平台 检查当前MCP Server 已适配的平台,并选择合适的平台
查看并对比可用的Tools 仔细查看可用的Tools的功能描述与所需的输入参数,并尝试运行对应的功能。
获取专属的URL或代码示例 检查账号登录状态与服务开通情况,生成唯一URL
去对应的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.
Available Tools
3 toolsget_objectB
Retrieves an object from VolcEngine TOS. In the GetObject request, specify the full key name for the object.
Args:
bucket: The name of the bucket.
key: The key of the object.
Returns:
If the object content is text format, return the content as string.
If the object content is binary format, return the content as base64 encoded string.
Inputs: bucket (required), key (required).
list_bucketsC
List all buckets in TOS.
Returns:
A list of buckets.
Inputs: no named parameters.
list_objectsC
List all objects in a bucket.
Args:
bucket: The name of the bucket.
prefix: The prefix to filter objects.
start_after: The start after key to filter objects.
continuation_token: The continuation token to filter objects.
Returns:
A list of objects.
Inputs: bucket (required), prefix, start_after, continuation_token.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose with no ambiguity. get_object retrieves specific object content, list_buckets enumerates available buckets, and list_objects lists objects within a bucket. The three tools cover different operations without overlap.
All tool names follow a consistent verb_noun pattern with snake_case formatting. get_object, list_buckets, and list_objects maintain perfect naming consistency throughout the toolset.
With only 3 tools, this feels thin for a storage service interface. While the tools cover basic read operations, the absence of create, update, or delete operations makes this feel incomplete rather than minimal. The count is borderline for the apparent scope.
Significant gaps exist in this TOS storage interface. While it provides read operations (get_object, list_buckets, list_objects), it lacks essential CRUD operations like create_bucket, put_object, delete_object, or delete_bucket. Agents will encounter dead ends when trying to perform basic storage workflows.
Related MCP Connectors
Search, organize and share the files in your S3-compatible buckets from your AI assistant.
1Browse, upload, download, and share files in your S3-compatible buckets with delegated roles.
Search and SQL on object storage: full-text, vector and hybrid search plus SQL over your data.
Browse, upload, download, copy, move and share files in your own S3-compatible buckets.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables 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.132Apache 2.0
- AlicenseBqualityDmaintenanceEnables AI assistants to manage MinIO object storage through comprehensive bucket operations, file uploads/downloads, batch processing, permissions management, and URL generation. Supports both automatic and manual connection modes with flexible authentication options.1918 npm2MIT
- AlicenseBqualityDmaintenanceEnables interaction with Tencent Cloud Object Storage (COS) through MCP protocol. Supports file upload, download, deletion, listing objects, and generating temporary signed URLs for cloud storage management.535 npmMIT
- AlicenseCqualityCmaintenanceEnables AI models to interact with Tencent Cloud COS for cloud storage operations (upload, download, list files) and advanced media processing capabilities (image super-resolution, QR code recognition, video thumbnails, document conversion, and natural language-based file search).21Apache 2.0