The official MCP server from TOS provides powerful query capabilities, allowing you to conveniently explore and find content stored in VolcEngine TOS using natural language. This enhances the intuitiveness and efficiency of data access.

Installation

UV Build

uv sync
uv build

UVX

uvx --from git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_tos mcp-server-tos

Configuration

Local Configuration

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_tos",
        "run",
        "mcp-server-tos"
      ]
    }
  }
}

UVX Configuration

{
  "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"
      }
    }
  }
}

Available Tools

Tool	Description
list_buckets	Requests a list of all storage buckets in your account, returns bucket name, creation time, location information, access domain, and other information
list_objects	Requests a list of objects in a specified storage bucket, each request returns part or all objects in the bucket (maximum 1000)
get_object	Retrieves the content of a specified object; for text files returns their content, for images, videos, and other binary objects returns the content in Base64 format

Features

• Convenient exploration and search of content stored in TOS using natural language
• Support for viewing VolcEngine TOS storage buckets list
• Support for listing objects in a bucket (maximum 1000)
• Support for retrieving content of text and binary objects
• Can be used in combination with VolcEngine MCP cloud products
• Support for pagination when listing objects
• Compatibility with Ark, Python, and Cursor platforms

Environment Variables

Required

• VOLCENGINE_ACCESS_KEY - VolcEngine account ACCESS KEY
• VOLCENGINE_SECRET_KEY - VolcEngine account SECRET KEY
• VOLCENGINE_REGION - VolcEngine TOS region
• TOS_ENDPOINT - VolcEngine TOS Endpoint

Optional

• SECURITY_TOKEN - VolcEngine Security Token, optional
• TOS_BUCKETS - specifies TOS buckets for access, optional

Usage Examples

List all VolcEngine TOS storage buckets

List objects in the example bucket in VolcEngine TOS

Read the content of a file named example.txt in the example bucket in VolcEngine TOS

Notes

Requires Python 3.10 or higher, uv must be installed. Service connection link: https://console.volcengine.com/tos. Licensed under MIT.