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"

可用工具列表

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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