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 服务器支持的所有工具命令及其功能描述：

• 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：列出指定本地路径中的所有文件和目录及其属性。

🔧 技术细节

文档未提及技术实现细节，故跳过此章节。

📄 许可证

文档未提及许可证信息，故跳过此章节。

⚠️ 重要提示

1. 所有操作均需遵循 AIStor 的安全策略和权限管理规范。
2. 配置文件中的路径需确保绝对正确，以避免意外的权限问题或数据丢失。
3. 在执行删除操作前，请务必确认操作的不可逆性，并做好数据备份。

通过以上功能和命令，您可以高效地管理和操作 AIStor 对象存储系统。