AIStor MCP 服务器指南

概述

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

注意事项

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

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