Tos MCP

🚀 Volcengine Object Storage TOS Unofficial MCP Tool

• An unofficial MCP tool for TOS

🚀 Quick Start

Using uv (Recommended, better portability)

Install uv

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Clone the project and install dependencies

git clone <repository-url>
cd tos-mcp

# Automatically install dependencies
uv sync

Run the server

# Run directly (Recommended)
uv run tos-mcp-server

# Or run via module
uv run python -m tos_mcp_server

Environment variable configuration

Copy the environment variable template:

cp .env.example .env

Edit the .env file and fill in the configuration, or set environment variables:

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"

📦 config Configuration

Using the uv method (Recommended)

Or if the project is in the user's directory:

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": ["run", "tos-mcp-server"],
      "cwd": "~/tos-mcp",
      "env": {
        "TOS_ACCESS_KEY": "your-access-key",
        "TOS_SECRET_KEY": "your-secret-key",
        "TOS_REGION": "cn-beijing", 
        "TOS_ENDPOINT": "https://tos-cn-beijing.volces.com"
      }
    }
  }
}

Using environment variables (.env file)

If you don't want to expose sensitive information in the configuration, you can use the .env file:

1. Copy and configure environment variables:

cp .env.example .env
# Edit the .env file and fill in your configuration

2. Simplified MCP configuration:

{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": ["run", "tos-mcp-server"],
      "cwd": "~/tos-mcp"
    }
  }
}

📚 API Test Status

🖼️ Test Images

Cline configuration test

Create a bucket

List buckets

Delete a bucket

Get bucket metadata

Generate a presigned URL

Download a TOS file to local

Upload a local file to TOS

List objects in a bucket

Delete a file

Get image metadata

Image processing, write back, and generate a presigned URL

Video frame capture, write back, and generate a presigned URL

📚 TOS Documentation

• Introduction to Python SDK: https://www.volcengine.com/docs/6349/92785
• Install Python SDK: https://www.volcengine.com/docs/6349/93479
• Initialize the client (Python SDK): https://www.volcengine.com/docs/6349/93483
• Quick start (Python SDK): https://www.volcengine.com/docs/6349/92786
• Common presigned (Python SDK): https://www.volcengine.com/docs/6349/135725
• Create a bucket (Python SDK): https://www.volcengine.com/docs/6349/92793
• List buckets (Python SDK): https://www.volcengine.com/docs/6349/92794
• Get bucket metadata (Python SDK): https://www.volcengine.com/docs/6349/92795
• Delete a bucket (Python SDK): https://www.volcengine.com/docs/6349/92796
• Common upload (Python SDK): https://www.volcengine.com/docs/6349/92800
• Common download (Python SDK): https://www.volcengine.com/docs/6349/92803
• List objects V2 (Python SDK): https://www.volcengine.com/docs/6349/173820
• Delete an object (Python SDK): https://www.volcengine.com/docs/6349/92805
• Basic image processing (Python SDK): https://www.volcengine.com/docs/6349/1157332
• Get image information (Python SDK): https://www.volcengine.com/docs/6349/1157336
• Persistent image processing (Python SDK): https://www.volcengine.com/docs/6349/1157338
• Video frame capture (Python SDK): https://www.volcengine.com/docs/6349/1157340
• Get video information (Python SDK): https://www.volcengine.com/docs/6349/1157341
• Get video information (Python SDK): https://www.volcengine.com/docs/6349/1157343