AIStor MCP 服务器

这是一个用于与 AIStor 对象存储交互的模型上下文协议 (MCP) 服务器。

有关 MCP 的更多信息，请访问其 官方网站。

有关 AIStor MCP 服务器的更多信息，请参阅我们的 博客文章。

功能

读取操作

• 列出存储桶
• 列出存储桶中的对象
• 获取对象的元数据和标签
• 为对象创建一个带有过期时间的预签名 URL

AI 操作

• 使用 ask-object 函数描述对象的内容

写入操作

这些操作应通过在配置中使用 --allow-write 标志来启用。

• 创建一个存储桶
• 将对象上传到存储桶
• 向对象添加标签

删除操作

这些操作应通过在配置中使用 --allow-delete 标志来启用。

• 删除一个对象
• 删除一个存储桶

管理员操作

这些操作应通过在配置中使用 --allow-admin 标志来启用。

• 以人类可读的形式获取集群信息（配置、健康状态、可用空间）

配置

前提条件

1. 从 Claude 下载并安装 Claude for Desktop 应用程序。 此 MCP 服务器与其他启用 MCP 的客户端一起使用，但让我们从 Claude 开始。

2. 确保您已安装 Docker 或 Podman，并准备好在您的桌面/笔记本电脑上使用。

3. 获取您的 AIStor（或 MinIO）对象存储凭据（MINIO_ACCESS_KEY 和 MINIO_SECRET_KEY）及其端点位置。 如果您没有可用的 AIStor 或 MinIO 服务器，请随意使用 MinIO Playground 服务器 的值。

配置文件

使用您喜欢的文本编辑器打开 Claude for Desktop 配置文件。 要在您的系统中找到配置文件，请按照模型上下文协议站点的 快速入门说明 进行操作。 其默认位置是：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

将以下行添加到配置文件，将凭据、端点和 YOUR_USERNAME 替换为它们的实际值。 此示例使用 Podman，但如果您使用 Docker，请将 command: 字段中的 podman 替换为 docker。 如果您配置了其他 MCP 服务器，只需将 AIStor 配置插入到列表中。

添加 --allow-* 标志时要小心。默认情况下，在没有任何标志的情况下，服务器将以只读模式运行。 仅当您需要时才将 --allow-write 和 --allow-delete 标志添加到此配置。 --allow-admin 标志启用收集有关集群信息的管理功能。

{
  "mcpServers": {
    "aistor": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/Users/YOUR_USERNAME/Downloads:/Downloads",
        "-e",
        "MINIO_ENDPOINT=REPLACE_WITH_ENDPOINT",
        "-e",
        "MINIO_ACCESS_KEY=REPLACE_WITH_ACCESS_KEY",
        "-e",
        "MINIO_SECRET_KEY=REPLACE_WITH_SECRET_KEY",
        "-e",
        "MINIO_USE_SSL=true",
        "quay.io/minio/aistor/mcp-server-aistor:latest",
        "--allowed-directories",
        "/Downloads",
        "--allow-write",
        "--allow-delete",
        "--allow-admin"
      ]
    }
  }
}

默认情况下，服务器列出并发送到 LLM 的对象或存储桶的数量限制为 1000 个对象。 这样做是为了避免达到模型上下文窗口中的 token 限制。 如果您的模型允许更宽的上下文窗口，您可以通过将 --max-keys 参数添加到配置文件来增加此数量。 请记住，每个对象记录包含几十个 token。

用法

以下是一些您可以执行的操作示例：

基本操作

• "列出我的 AIStor 服务器上的所有存储桶"
• "列出存储桶 test 的内容"

文件操作

• "将文件 example.pdf 下载到我的 Downloads 目录"
• "创建一个存储桶 my-bucket"
• "将 document.pdf 从 Downloads 上传到存储桶 my-bucket"

元数据操作

• "获取存储桶 my-bucket 中 file.pdf 的元数据"
• "列出对象 config.json 的所有标签"

管理员操作

• "显示服务器健康状态"
• "获取存储使用情况统计信息"

每个命令将返回具有相关信息的人类可读的响应。

可用工具

通常，大型语言模型 (LLM) 将能够确定使用哪个工具来满足您的请求。 有时，您可能希望明确告诉模型使用哪个工具。 对于这种情况，以及让您了解此 MCP 服务器还可以做什么，以下是此版本中可用的工具列表。

您始终可以通过单击 Claude for Desktop 应用程序中的锤子图标来获取此列表。

ask-object : 使用 AI 提问有关对象内容的问题，支持各种文件格式并返回上下文答案

copy-object : 将对象从一个存储桶复制到另一个存储桶，同时保留元数据并可选择修改属性。您还可以指定版本 ID 以复制对象的特定版本。

create-bucket : 创建具有指定配置和可选版本控制设置的新存储桶

delete-bucket : 删除存储桶，并可选择强制删除所有包含的对象

delete-object : 从存储桶中删除特定对象或版本，并可选择软删除支持。您还可以指定版本 ID 以删除对象的特定版本。

download-object : 从指定的存储桶下载对象到本地文件系统，并保留元数据。您还可以指定版本 ID 以下载对象的特定版本。

get-admin-info : 获取有关 AIStor 对象存储的全面技术信息，包括状态、性能指标和配置

get-bucket-lifecycle : 获取指定存储桶的生命周期，也称为生命周期规则，也称为 ILM 配置

get-bucket-replication : 获取指定存储桶的复制配置

get-bucket-tags : 获取指定存储桶的标签

get-bucket-versioning : 获取指定存储桶的版本控制状态和配置

get-data-usage-info : 获取 AIStor 对象存储的数据使用情况信息，包括存储的总数据、对象数量以及每个存储桶的使用情况

get-object-metadata : 获取对象的详细元数据，包括内容类型、大小、自定义标头和系统属性

get-object-presigned-url : 获取存储桶中对象的预签名 URL，并带有可选的过期时间。默认值为 7 天。

get-object-tags : 获取与存储桶中特定对象关联的所有标签

get-object-versions : 获取存储桶中对象的所有版本

list-allowed-directories : 列出服务器允许操作的所有目录

list-bucket-contents : 列出指定存储桶中的所有对象，包括它们的大小和上次修改日期。您还可以指定前缀来过滤对象以及是否列出版本。

list-buckets : 列出 AIStor 对象存储中的所有存储桶及其基本信息

list-local-files : 列出指定本地目录路径中的所有文件和目录及其属性

move-object : 通过复制到目标并从源删除来在存储桶之间移动对象。您还可以指定版本 ID 以移动对象的特定版本。

set-bucket-tags : 设置指定存储桶的标签

set-bucket-versioning : 使用管理权限配置存储桶的版本控制设置

set-object-tags : 设置或更新存储桶中现有对象的标签，支持多个键值对。您还可以指定版本 ID 以设置对象的特定版本的标签。

upload-object : 将文件从本地文件系统上传到指定的存储桶，并支持元数据和标签