MCP Server Aistor

🚀 AIStor MCP サーバーガイド

AIStor MCP（モデルコンテキストプロトコル）サーバーは、AIStor オブジェクトストレージシステムを管理および操作するためのツールです。このドキュメントでは、このサーバーの機能、設定、および使用方法に関する詳細情報を提供します。

🚀 クイックスタート

AIStor MCP サーバーを使用することで、AIStor オブジェクトストレージシステムを効率的に管理および操作できます。まずは、以下の機能や設定、使用方法をご確認ください。

✨ 主な機能

1. 読み取り操作

• バケットの一覧表示：AIStor ストレージシステム内のすべてのバケットとその基本情報を取得します。
• バケット内容の一覧表示：指定されたバケット内のすべてのオブジェクトを、ファイルサイズと最終更新日時を含めて一覧表示します。接頭辞フィルタリングとバージョンリスト機能をサポートしています。
• オブジェクトのダウンロード：指定されたバケット内のオブジェクトをローカルファイルシステムにダウンロードし、メタデータ情報を保持します。バージョン ID を指定してダウンロードすることもできます。

2. AI 操作

• オブジェクト内容の質問：人工知能を使用して指定されたオブジェクトの内容を分析し、コンテキストに基づく回答を返します。複数のファイル形式をサポートしています。

3. 書き込み操作

• オブジェクトのアップロード：ローカルファイルを指定されたバケットにアップロードし、メタデータとタグの設定をサポートしています。
• バケットの作成：新しいストレージバケットを作成し、バージョン管理やその他の設定を構成することができます。

4. 削除操作

• オブジェクトの削除：指定されたバケットから特定のオブジェクトまたはその特定のバージョンを削除します。ソフト削除機能をサポートしており、バージョン ID を指定して削除することができます。
• バケットの削除：指定されたバケットとそれに含まれるすべてのオブジェクトを削除します。すべての内容を強制的に削除することも選択できます。

5. コピーと移動

• オブジェクトのコピー：オブジェクトをあるバケットから別のバケットにコピーし、メタデータ情報を保持します。バージョン ID を指定してコピーすることができます。
• オブジェクトの移動：オブジェクトをソースバケットからターゲットバケットに移動し、ターゲット側に新しいオブジェクトを作成してソース側のオブジェクトを削除します。バージョン ID を指定して移動することができます。

6. 管理操作

• ストレージバケットのライフサイクルルールの取得：指定されたバケットのライフサイクル設定（スマートライフサイクル管理 ILM ルールを含む）を確認します。
• ストレージバケットの複製設定の取得：指定されたバケットの複製設定を確認します。
• ストレージバケットのタグの取得：指定されたバケットのすべてのタグ情報を確認します。
• ストレージバケットのバージョン管理状態の取得：指定されたバケットのバージョン管理状態と設定を確認します。
• ストレージ使用状況の取得：AIStor ストレージシステム全体のデータ使用状況を取得し、総ストレージ容量、オブジェクト数、およびバケット別の使用状況を含みます。
• オブジェクトのメタデータの取得：指定されたオブジェクトの詳細なメタデータ情報を取得し、MIME タイプ、サイズ、カスタムヘッダー、およびシステム属性を含みます。
• オブジェクトの署名付き URL の取得：指定されたバケット内のオブジェクトに対して、オプションの有効期限付きの署名付き URL を生成します。デフォルトの有効期限は 7 日です。
• オブジェクトのタグの取得：指定されたオブジェクトのすべてのタグ情報を取得します。
• オブジェクトのバージョンリストの取得：指定されたオブジェクトのすべてのバージョンを一覧表示します。

7. その他

• 許可されたディレクトリの一覧表示：サーバーがサポートするすべての操作ディレクトリを一覧表示します。
• ローカルファイルの一覧表示：指定されたローカルパス内のすべてのファイルとディレクトリおよびその属性を一覧表示します。

📦 インストール

このセクションでは、AIStor MCP サーバーの設定について説明します。設定は JSON 形式の設定ファイルを使用して行います。以下は設定例です。

{
    "allowed_directories": [
        "/path/to/directory1",
        "/path/to/directory2"
    ],
    "buckets": {
        "bucket1": {
            "versioning": true,
            "tags": {
                "tag1": "value1",
                "tag2": "value2"
            }
        },
        "bucket2": {
            "versioning": false
        }
    }
}

📚 ドキュメント

コマンド一覧

以下は、AIStor MCP サーバーがサポートするすべてのツールコマンドとその機能説明です。

• ask-object：人工知能を使用して指定されたオブジェクトの内容を分析し、複数のファイル形式をサポートし、コンテキストに基づく回答を返します。
• copy-object：オブジェクトをあるバケットから別のバケットにコピーし、メタデータ情報を保持します。バージョン ID を指定してコピーすることができます。
• create-bucket：新しいストレージバケットを作成し、その属性とバージョン管理設定を構成します。
• delete-bucket：指定されたバケットとそれに含まれるすべてのオブジェクトを削除します。すべての内容を強制的に削除することも選択できます。
• delete-object：指定されたバケットから特定のオブジェクトまたはその特定のバージョンを削除します。ソフト削除機能をサポートし、バージョン ID を指定して削除することができます。
• download-object：指定されたバケット内のオブジェクトをローカルファイルシステムにダウンロードし、メタデータ情報を保持します。バージョン ID を指定してダウンロードすることができます。
• get-admin-info：AIStor ストレージシステムの詳細な管理情報を取得し、すべてのストレージノード、ボリューム、およびバケットの状態を含みます。
• get-bucket-lifecycle：指定されたバケットのライフサイクルルール設定（スマートライフサイクル管理 ILM ルールを含む）を取得します。
• get-bucket-replication：指定されたバケットの複製設定を取得します。
• get-bucket-tags：指定されたバケットのすべてのタグ情報を取得します。
• get-bucket-versioning：指定されたバケットのバージョン管理状態と設定を取得します。
• get-storage-usage：AIStor ストレージシステム全体のデータ使用状況を取得し、総ストレージ容量、オブジェクト数、およびバケット別の使用状況を含みます。
• get-object-metadata：指定されたオブジェクトの詳細なメタデータ情報を取得し、MIME タイプ、サイズ、カスタムヘッダー、およびシステム属性を含みます。
• get-object-signed-url：指定されたバケット内のオブジェクトに対して、オプションの有効期限付きの署名付き URL を生成します。デフォルトの有効期限は 7 日です。
• get-object-tags：指定されたオブジェクトのすべてのタグ情報を取得します。
• get-object-versions：指定されたオブジェクトのすべてのバージョンを一覧表示します。
• list-allowed-directories：サーバーがサポートするすべての操作ディレクトリを一覧表示します。
• list-local-files：指定されたローカルパス内のすべてのファイルとディレクトリおよびその属性を一覧表示します。

⚠️ 重要提示

• すべての操作は、AIStor のセキュリティポリシーとアクセス権管理規範に従う必要があります。
• 設定ファイル内のパスは、絶対に正しいことを確認してください。誤ったパスによるアクセス権問題やデータ損失を避けるためです。
• 削除操作を実行する前に、操作の不可逆性を確認し、データのバックアップを行ってください。

以上の機能とコマンドを使用することで、AIStor オブジェクトストレージシステムを効率的に管理および操作することができます。