TOS

You can run a dedicated MCP server to manage Volcngine ToS (TOS) object storage operations through a configurable command interface. This server lets you perform bucket and object management, pre-signed URL generation, and media processing workflows through a consistent set of MCP endpoints. Use it to connect your MCP client to the TOS service and automate common storage tasks.

How to use

Start by running the MCP server locally or remotely and connect your MCP client to the provided endpoint. The server exposes a set of endpoints for bucket management (create, list, get metadata, delete), object management (put, get, list, delete), pre-signed URL generation, and media processing features for images and videos. Use the configured MCP entry (name you choose) to reference the server in your client configuration. Ensure you have your access and secret keys ready and configured as environment variables for secure access.

How to install

Prerequisites: Node-compatible runtime and the MCP runner tool uvx are required to run this server from the given configuration.

# Install prerequisites (macOS example)
# Install Homebrew if not present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python 3 (if needed)
brew install python@3.12

# Install uv (Python package runner)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Reload shell configuration
source ~/.zshrc  # if using zsh
# or
source ~/.bash_profile  # if using bash

# Run MCP directly from GitHub (recommended, no clone needed)
uvx --from git+https://github.com/jneless/tos-mcp.git tos-mcp-server

# If you prefer cloning locally
git clone https://github.com/jneless/tos-mcp.git
cd tos-mcp

# Install dependencies
uv sync

# Run the MCP server
uv run tos-mcp-server

Configuration and environment

Set up your environment variables to authenticate with Volcengine TOS. You can copy the example and fill in your values, or export them directly in your shell.

cp .env.example .env

export TOS_ACCESS_KEY="your_access_key"
export TOS_SECRET_KEY="your_secret_key"
export TOS_REGION="cn-beijing"
export TOS_ENDPOINT="https://tos-cn-beijing.volces.com"

Available tools

tos_create_bucket

Creates a new storage bucket in ToS.

tos_list_buckets

Lists all buckets available for your account.

tos_get_bucket_meta

Fetches metadata for a specific bucket.

tos_delete_bucket

Deletes a bucket and its contents.

tos_put_object

Uploads an object to a bucket.

tos_get_object

Downloads an object from a bucket.

tos_list_objects

Lists objects inside a bucket.

tos_delete_object

Deletes an object from a bucket.

tos_presigned_url

Generates a pre-signed URL for upload or download.

tos_image_process

Performs basic image processing and persistence.

tos_image_info

Retrieves image information.

tos_video_snapshot

Captures a video frame as a snapshot.

tos_video_info

Retrieves video information.