Sample TOS Model Context Protocol Server

Features

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. In the GetObject request, specify the full key name for the object. General purpose buckets - Both the virtual-hosted-style requests and the path-style requests are supported

Configuration

• VOLC_ACCESSKEY

  : Required, The access key for the VolcEngine.

• VOLC_SECRETKEY

  : Required, The secret key for the VolcEngine.

• REGION

  : Required, The region for the TOS service.

• TOS_ENDPOINT

  : Required, The endpoint for the TOS service.

• SECURITY_TOKEN

  : Optional, The security token for the credential.

• TOS_BUCKETS

  : Optional, If you want to use a specific bucket, you need to set this.

MCP Settings Configuration

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

{
    "mcpServers": {
        "tls": {
            "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"
            }
        }
    }
}

Usage

Running the Server

# Run the server with stdio transport (default)
tos-mcp-server

License