🚀 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"