Minio MCP Server Aistor

🚀 AIStor MCP 服务器指南

AIStor MCP 服务器基于 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"

📚 详细文档

可用工具列表

以下是当前版本中可用的所有工具及其功能描述：

问对象内容 : 使用 AI 分析特定对象的内容，支持多种文件格式，并返回上下文相关的答案。

复制对象 : 将对象从一个桶复制到另一个桶，保留元数据，可自定义属性。支持指定版本 ID 进行复制。

创建桶 : 新建一个带有指定配置的桶，可设置版本控制选项。

删除桶 : 删除指定桶及其内容（可选）。

删除对象 : 删除特定对象或其指定版本。支持软删除功能，并可通过版本 ID 指定要删除的具体对象版本。

下载对象 : 从指定桶下载对象到本地文件系统，保留元数据。支持通过版本 ID 下载特定版本的对象。

获取存储信息 : 获取 AIStor 对象存储的全面技术信息，包括运行状态、性能指标和配置详情。

获取桶生命周期规则 : 查看指定桶的生命周期规则（也称为 ILM 配置）。

获取桶复制配置 : 检查指定桶的复制设置。

获取桶标签 : 获取特定桶的所有标签信息。

获取桶版本控制状态 : 了解桶的版本控制启用情况及详细配置。

获取数据使用情况 : 统计整个 AIStor 存储的数据量、对象数量及各桶的具体使用情况。

获取对象元数据 : 查看特定对象的详细元数据信息，包括内容类型、大小、自定义头和系统属性。

获取对象签名 URL : 为指定对象生成带有过期时间的访问链接，默认 7 天有效。

获取对象标签 : 获取特定对象的所有关联标签信息。

获取对象版本列表 : 查看指定对象的所有可用版本。

列出允许目录 : 列出所有被授权进行操作的本地目录。

列出桶内容 : 检索特定桶中的所有对象及其详细信息（大小、最后修改时间等）。

上传对象 : 从本地文件系统上传文件到指定桶，支持自定义元数据和标签。