Minio MCP Server Aistor

🚀 AIStor MCPサーバーガイド

AIStor MCPサーバーは、AIStorオブジェクトストレージサービスとのやり取りを可能にするツールです。このドキュメントでは、MCPベースのAIStorサーバーの機能、設定方法、使用例を詳しく説明します。

🚀 クイックスタート

MCP（モデルコンテキストプロトコル）は、AIStorオブジェクトストレージサービスとのやり取りに使用されるプロトコルです。このドキュメントでは、MCPベースのAIStorサーバーの操作方法を詳細に説明します。

✨ 主な機能

読み取り操作

• バケットの一覧表示：AIStorストレージ内のすべてのバケットを取得します。
• バケット内容の一覧表示：特定のバケット内のすべてのオブジェクトとその詳細情報（サイズ、最終更新日時など）を取得します。
• オブジェクトのダウンロード：指定されたバケットからオブジェクトをローカルファイルシステムにダウンロードし、メタデータを保持します。

AI操作

• オブジェクト内容の質問：AIを使用してオブジェクトの内容を分析し、コンテキストに関連する回答を生成します。複数のファイル形式に対応しています。

書き込み操作

• バケットの作成：指定された設定で新しいバケットを作成し、バージョン管理を設定できます。
• オブジェクトのアップロード：ローカルファイルシステムから指定されたバケットにファイルをアップロードし、メタデータとラベルをサポートします。

削除操作

• バケットの削除：指定されたバケットとその内容を削除します（オプション）。
• オブジェクトの削除：特定のオブジェクトまたはその指定されたバージョンを削除します。

管理機能

• バケットのライフサイクルルールの取得：バケットのライフサイクル設定を確認します。
• バケットの複製設定の取得：バケットの複製設定を確認します。
• バケットのラベルの取得：バケットのすべてのラベル情報を取得します。
• バケットのバージョン管理状態の取得：バケットのバージョン管理の有効化状態と設定を確認します。

その他の機能

• ストレージ使用状況の取得：AIStorストレージ全体のデータ量、オブジェクト数、各バケットの使用状況を統計します。
• オブジェクトのメタデータの取得：特定のオブジェクトの詳細なメタデータ情報（コンテンツタイプ、サイズなど）を確認します。
• オブジェクトの署名付きURLの取得：有効期限付きのオブジェクトアクセスリンクを生成します。デフォルトは7日間です。

📦 インストール

環境変数の設定

# 環境変数設定の例
export MINIO_ENDPOINT=minio.example.com:9000
export MINIO_ACCESS_KEY=your_access_key
export MINIO_SECRET_KEY=your_secret_key

インストールと起動

1. インストール：AIStor MCPサーバーをダウンロードしてインストールします。
2. 設定：設定ファイルを編集し、ストレージパスとアクセス権限を設定します。
3. サービスの起動：コマンド ./ai-stor-mcp start を使用してサービスを起動します。

💻 使用例

基本的な使用法

例1：すべてのバケットを一覧表示する

# すべてのバケットを一覧表示する
list-buckets

# 出力例：
Bucket1
Bucket2

例2：ファイルをアップロードする

upload-object --bucket my-bucket --file local-file.txt --metadata "key=value"

📚 ドキュメント

利用可能なツールの一覧

以下は、現在のバージョンで利用可能なすべてのツールとその機能の説明です。

問对象内容 : AIを使用して特定のオブジェクトの内容を分析し、コンテキストに関連する回答を生成します。複数のファイル形式に対応しています。

复制对象 : オブジェクトを1つのバケットから別のバケットにコピーし、メタデータを保持します。属性をカスタマイズできます。コピーするバージョンIDを指定できます。

创建桶 : 指定された設定で新しいバケットを作成し、バージョン管理オプションを設定できます。

删除桶 : 指定されたバケットとその内容を削除します（オプション）。

删除对象 : 特定のオブジェクトまたはその指定されたバージョンを削除します。ソフト削除機能をサポートし、バージョンIDで削除する特定のオブジェクトバージョンを指定できます。

下载对象 : 指定されたバケットからオブジェクトをローカルファイルシステムにダウンロードし、メタデータを保持します。バージョンIDを使用して特定のバージョンのオブジェクトをダウンロードできます。

获取存储信息 : AIStorオブジェクトストレージの包括的な技術情報を取得します。実行状態、パフォーマンス指標、設定詳細を含みます。

获取桶生命周期规则 : 指定されたバケットのライフサイクルルール（ILM設定とも呼ばれます）を確認します。

获取桶复制配置 : 指定されたバケットの複製設定を確認します。

获取桶标签 : 特定のバケットのすべてのラベル情報を取得します。

获取桶版本控制状态 : バケットのバージョン管理の有効化状態と詳細な設定を確認します。

获取数据使用情况 : AIStorストレージ全体のデータ量、オブジェクト数、各バケットの具体的な使用状況を統計します。

获取对象元数据 : 特定のオブジェクトの詳細なメタデータ情報を確認します。コンテンツタイプ、サイズ、カスタムヘッダー、システム属性を含みます。

获取对象签名URL : 指定されたオブジェクトの有効期限付きのアクセスリンクを生成します。デフォルトは7日間です。

获取对象标签 : 特定のオブジェクトのすべての関連ラベル情報を取得します。

获取对象版本列表 : 指定されたオブジェクトのすべての利用可能なバージョンを確認します。

列出允许目录 : 操作が許可されているすべてのローカルディレクトリを一覧表示します。

列出桶内容 : 特定のバケット内のすべてのオブジェクトとその詳細情報（サイズ、最終更新日時など）を取得します。

上传对象 : ローカルファイルシステムから指定されたバケットにファイルをアップロードし、カスタムメタデータとラベルをサポートします。