VolcEngine TOS Client MCP Server

Cloud PlatformsPython

Access and manage VolcEngine TOS (object storage) resources

Available Tools

list_buckets

Returns a list of all buckets owned by the authenticated sender of the request

list_objects

Returns some or all (up to 1,000) of the objects in a bucket with each request

get_object

Retrieves an object from VolcEngine TOS by specifying the full key name for the object

The VolcEngine TOS Client provides a seamless interface to interact with VolcEngine's Tinder Object Storage service. This MCP server allows you to list buckets, browse objects within buckets, and retrieve specific objects directly from your TOS storage. With this integration, you can easily incorporate cloud storage operations into your workflows, enabling efficient data management and retrieval from VolcEngine's cloud infrastructure. The client handles authentication and API communication, providing a straightforward way to access your cloud storage resources.

Installation

To use the VolcEngine TOS Client, you'll need to add it to your MCP configuration. There are two ways to set it up:

Method 1: Local Installation

Clone the repository:

git clone https://github.com/dinghuazhou/sample-mcp-server-tos.git

Add the following configuration to your MCP settings file:

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

Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER with the actual path where you cloned the repository.

Method 2: Direct Installation from GitHub

Add the following configuration to your MCP settings file:

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/ai-app-lab#subdirectory=mcp/server/mcp_server_tos",
        "mcp-server-tos"
      ],
      "env": {
        "VOLC_ACCESSKEY": "your ak",
        "VOLC_SECRETKEY": "your sk",
        "REGION": "tos region",
        "TOS_ENDPOINT": "tos endpoint",
        "SECURITY_TOKEN": "your security token",
        "TOS_BUCKET": "your specific bucket"
      }
    }
  }
}

Configuration

The server requires the following environment variables:

VOLC_ACCESSKEY: (Required) Your VolcEngine access key
VOLC_SECRETKEY: (Required) Your VolcEngine secret key
REGION: (Required) The region for the TOS service
TOS_ENDPOINT: (Required) The endpoint for the TOS service
SECURITY_TOKEN: (Optional) Security token for the credential
TOS_BUCKETS: (Optional) Specific bucket to use

You can set these environment variables in your shell or include them in the MCP configuration as shown in Method 2 above.

Usage

Once configured, you can use the VolcEngine TOS Client to:

List all buckets in your VolcEngine account
Browse objects within a specific bucket
Retrieve individual objects from your storage

The client supports both virtual-hosted-style requests and path-style requests for general purpose buckets.

When making requests through the MCP interface, you'll use the tools provided by this server to interact with your VolcEngine TOS resources.