Tos MCP

🚀 火山引擎 对象存储 TOS 非公式 MCPツール

• TOS 非公式 MCP ツール

このツールは、火山エンジンのオブジェクトストレージ TOS を支援する非公式のMCPツールです。簡単な設定でTOSの操作を行うことができます。

🚀 クイックスタート

uvを使用する（推奨、移植性が高い）

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"

プロジェクトのクローンと依存関係のインストール

git clone <repository-url>
cd tos-mcp

# 依存関係を自動的にインストール
uv sync

サーバーの起動

# 直接起動（推奨）
uv run tos-mcp-server

# またはモジュールを通じて起動
uv run python -m tos_mcp_server

環境変数の設定

環境変数テンプレートをコピーします：

cp .env.example .env

.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"

📚 設定について

uv方式を使用する（推奨）

もしプロジェクトがユーザーディレクトリにある場合：

{
  "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"
      }
    }
  }
}

環境変数方式（.envファイル）

設定で機密情報を公開したくない場合は、.envファイルを使用できます：

1. 環境変数をコピーして設定します：

cp .env.example .env
# .envファイルを編集して設定を入力

2. 簡略化されたMCP設定：

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

📄 APIテスト状況

🖼️ テスト画像

Cline設定テスト

バケットの作成

バケットの列挙

バケットの削除

バケットのメタデータの取得

事前署名URLの生成

TOSファイルのローカルへのダウンロード

ローカルファイルのTOSへのアップロード

バケット内のオブジェクトの列挙

ファイルの削除

画像のメタ情報の取得

画像処理と書き戻し、事前署名URLの生成

ビデオのフレームキャプチャと書き戻し、事前署名URLの生成

📖 TOSドキュメント

• Python SDKの概要:https://www.volcengine.com/docs/6349/92785
• Python SDKのインストール:https://www.volcengine.com/docs/6349/93479
• クライアントの初期化（Python SDK）:https://www.volcengine.com/docs/6349/93483
• クイックスタート（Python SDK）:https://www.volcengine.com/docs/6349/92786
• 通常の事前署名（Python SDK）:https://www.volcengine.com/docs/6349/135725
• バケットの作成(PythonSDK):https://www.volcengine.com/docs/6349/92793
• バケットの列挙(PythonSDK):https://www.volcengine.com/docs/6349/92794
• バケットのメタデータの取得(PythonSDK):https://www.volcengine.com/docs/6349/92795
• バケットの削除(PythonSDK):https://www.volcengine.com/docs/6349/92796
• 通常のアップロード（Python SDK）:https://www.volcengine.com/docs/6349/92800
• 通常のダウンロード（Python SDK）:https://www.volcengine.com/docs/6349/92803
• オブジェクトの列挙 V2（Python SDK）:https://www.volcengine.com/docs/6349/173820
• オブジェクトの削除（Python SDK）:https://www.volcengine.com/docs/6349/92805
• 基本的な画像処理（Python SDK）:https://www.volcengine.com/docs/6349/1157332
• 画像情報の取得（Python SDK）:https://www.volcengine.com/docs/6349/1157336
• 画像処理の永続化（Python SDK）:https://www.volcengine.com/docs/6349/1157338
• ビデオのフレームキャプチャ（Python SDK）:https://www.volcengine.com/docs/6349/1157340
• ビデオ情報の取得（Python SDK）:https://www.volcengine.com/docs/6349/1157341
• ビデオ情報の取得（Python SDK）:https://www.volcengine.com/docs/6349/1157343