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 存儲系統的詳細管理信息，包括所有存儲節點、卷和 bucket 的狀態。
• 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 對象存儲系統。