Sample TOS Model Context Protocol Server

TOS MCP サーバー

TOS が公式に提供する MCP サーバーは強力な検索機能を備えており、自然言語を使って TOS に保存されたコンテンツを簡単に探索、検索できます。これにより、データアクセスの直感性と効率が向上します。火山引擎のクラウド製品と組み合わせることで、よりスマートなビジネスシナリオの構築を支援します。

バージョン	v0.2.0
説明	MCP に基づいて TOS リソースを管理し、データをインテリジェントに探索します
カテゴリ	ストレージ
タグ	検索、動画、画像、テキスト

ツール

この MCP サーバー製品は、以下のツール（機能）を提供します。

ツール 1: list_buckets

種類

SaaS

詳細な説明

このツールを使うと、火山引擎 TOS のバケット一覧を簡単に確認できます。

デバッグに必要な入力パラメーター：

入力：

{
  "inputSchema": {
    "type": "object",
    "required": [],
    "properties": {}
  },
  "name": "list_buckets",
  "description": "查询您账号下拥有的所有存储桶的列表。"
}

出力：

• アカウントが所有するバケット一覧を返します。バケット名、作成日時、バケットの場所に関する情報、アクセスドメインなどが含まれます。

最も呼び出されやすいプロンプトの例

列举火山引擎 TOS 的存储桶列表。

ツール 2: list_objects

種類

SaaS

詳細な説明

このツールを使うと、火山引擎 TOS のバケット内のオブジェクト一覧を簡単に確認できます。リクエストごとに、バケット内のオブジェクトの一部またはすべて（最大 1000 個）が返されます。リクエストパラメーターを選択条件として使用することで、バケット内のオブジェクトの一部を取得できます。

デバッグに必要な入力パラメーター：

入力：

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "prefix": {
        "type": "string",
        "description": "可选的对象前缀"
      },
      "start_after": {
        "type": "string",
        "description": "列举对象的起始位置。您可以通过指定对象的起始位置分页列举对象"
      },
      "continuation_token": {
        "type": "string",
        "description": "指定列举操作从该 Token 开始，通常从上次请求返回的 NextContinuationToken 中获取此 Token"
      }
    }
  },
  "name": "list_objects",
  "description": "查询您指定存储桶的对象列表"
}

出力：

• 指定したストレージ内のオブジェクト一覧を返します。オブジェクト名、オブジェクトの最終更新日時、ETag、オブジェクトのサイズ、ストレージタイプなどが含まれます。

最も呼び出されやすいプロンプトの例

列举火山引擎 TOS 的 example 桶下的对象。

ツール 3: get_object tool

種類

SaaS

詳細な説明

TOS からオブジェクトを取得します。バケット名とオブジェクトの完全なパスを指定する必要があります。テキストファイルや CSV ファイルなどのテキストコンテンツを含むオブジェクトの場合、このツールはその内容を返します。画像や動画などのバイナリーオブジェクトの場合、このツールは Base64 エンコードされた内容を返します。

デバッグに必要な入力パラメーター：

入力：

{
  "inputSchema": {
    "type": "object",
    "required": [
      "bucket",
      "key"
    ],
    "properties": {
      "bucket": {
        "type": "string",
        "description": "用户指定的存储桶名称"
      },
      "key": {
        "type": "string",
        "description": "用户需要读取的对象名，需要指定完整的对象名"
      }
    }
  },
  "name": "get_object",
  "description": "获取指定对象的内容，对于文本内容的对象，比如文本文件、CSV 文件等，该工具返回的是其内容。对于图片、视频等二进制对象，该工具返回的是Base64编码的内容。"
}

出力：

• 指定したオブジェクトの内容を返します。テキストファイルや CSV ファイルなどのテキストコンテンツを含むオブジェクトの場合、このツールはその内容を返します。画像や動画などのバイナリーオブジェクトの場合、このツールは Base64 エンコードされた内容を返します。

最も呼び出されやすいプロンプトの例

读取火山引擎 TOS 桶example下对象名为example.txt的文件内容

対応プラットフォーム

方舟、python、cursor

サービス開通リンク（製品全体）

https://console.volcengine.com/tos

認証方式

火山引擎：volcengine の管理コンソールから volcengine のアクセスキー ID、シークレットアクセスキー、リージョンを取得し、.env ファイルに関連する環境変数を設定してください。

環境変数

以下の環境変数を使用して MCP サーバーを設定できます。

環境変数	説明	デフォルト値
VOLCENGINE_ACCESS_KEY	火山引擎アカウントの ACCESS KEY	-
VOLCENGINE_SECRET_KEY	火山引擎アカウントの SECRET KEY	-
VOLCENGINE_REGION	火山引擎 TOS の region	-
TOS_ENDPOINT	火山引擎 TOS の Endpoint	-
SECURITY_TOKEN	火山引擎の Security Token（任意）	-
TOS_BUCKETS	アクセスする TOS バケットの指定（任意）	-

インストールとデプロイ

システム要件

• Python 3.10 以降をインストールします
• uv をインストールします
  • Linux システムの場合

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

  • Windows システムの場合

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

• 依存関係を同期し、uv.lock を更新します。

  uv sync
  

• MCP サーバーをビルドします。

  uv build
  

uv を使用する（推奨）

uv を使用する場合、特別なインストールは必要ありません。uvx を使用して mcp-server-tos を直接実行します。

ローカル設定

以下の設定を mcp 設定ファイルに追加してください。

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

各プラットフォームでの設定

方舟

体験センター

[以下に例を示します]

1. MCP サーバーの詳細を確認する 大規模言語モデルのエコシステム広場で、適切な MCP サーバーを選択し、詳細を確認します
2. MCP サーバーを実行するプラットフォームを選択する 現在の MCP サーバーが対応しているプラットフォームを確認し、適切なプラットフォームを選択します
3. 利用可能なツールを確認して比較する 利用可能なツールの機能説明と必要な入力パラメーターをよく確認し、対応する機能の実行を試します。
4. 専用の URL またはコード例を取得する アカウントのログイン状態とサービスの開通状況を確認し、一意の URL を生成します
5. 対応するクライアントのプラットフォームで使用する クイックリンクボタンをクリックして、方舟プラットフォームの体験センターに移動し、対象の MCP サーバーを試します

製品のスクリーンショット／動画（任意）

Cursor

デプロイ

[以下に例を示します]

UVX

{
  "mcpServers": {
    "tos-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_tos",
        "mcp-server-tos"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "tos region",
        "TOS_ENDPOINT": "tos endpoint",
        "SECURITY_TOKEN": "your security token",
        "TOS_BUCKET": "your specific bucket"
      }
    }
  }
}

ライセンス

volcengine/mcp-server は MIT License に基づいてライセンスされています。