Minio MCP Server Aistor

🚀 AIStor MCP 服務器指南

AIStor MCP 服務器基於 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"