Sample MCP Server Tos

🚀 TOS Model Context Protocol Server Example - MCP Service

An implementation of an MCP server for extracting data from TOS.

🚀 Quick Start

This is an MCP server implementation designed to extract data from TOS. It provides several useful tools and requires specific environment variables for configuration.

✨ 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) objects in a bucket. Each request returns a certain number of objects.

• get_object
  Retrieves an object from VolcEngine TOS. In a GetObject request, specify the full key name of the object to retrieve. General-purpose buckets support both virtual-hosted-style requests and path-style requests.

📦 Installation

Configuration

This server requires the following environment variables to be set:

• VOLC_ACCESSKEY: Required. The access key for VolcEngine.
• VOLC_SECRETKEY: Required. The secret key for VolcEngine.
• REGION: Required. The region where the TOS service is located.
• TOS_ENDPOINT: Required. The endpoint of the TOS service.
• SECURITY_TOKEN: Optional. The security token for the credentials.
• TOS_BUCKETS: Optional. Set this variable if you want to use specific buckets.

You can set these environment variables in the shell.

MCP Setup Configuration

To add this server to your MCP configuration, add the following content 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"
      ]
    }
  }
}

Or

{
    "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": "specific bucket you want to use"
            }
        }
    }
}

💻 Usage Examples

Running the Server

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

📄 License

This library is released under the MIT-0 license. For more details, please refer to the LICENSE file.