AIStor MCP服务器
这是一个用于与 AIStor 对象存储交互的模型上下文协议 (MCP) 服务器。
有关 MCP 的更多信息可以在其官方网站上找到。
有关 AIStor MCP 服务器的更多信息，请参阅我们的博客文章。
特征
读取操作
列出存储桶
列出存储桶中的对象
获取对象的元数据和标签
为对象创建具有有效期的预签名 URL
AI操作
使用
ask-object函数描述对象的内容
写入操作
应使用配置中的--allow-write标志来启用这些操作。
创建存储桶
将对象上传到存储桶
为对象添加标签
删除操作
应使用配置中的--allow-delete标志来启用这些操作。
删除对象
删除存储桶
管理员操作
应使用配置中的--allow-admin标志来启用这些操作。
以人类可读的形式获取集群信息（配置、健康状态、可用空间）
Related MCP server: Azure MCP Server
配置
先决条件
从Claude下载并安装 Claude 桌面版应用程序。此 MCP 服务器可与其他支持 MCP 的客户端配合使用，但我们先从 Claude 开始。
确保您已安装 Docker 或 Podman 并准备在您的台式机/笔记本电脑上使用。
获取你的 AIStor（或 MinIO）对象存储凭证（
MINIO_ACCESS_KEY和MINIO_SECRET_KEY）及其端点位置。如果你没有可用的 AIStor 或 MinIO 服务器，可以使用MinIO Playground 服务器的值。
配置文件
使用您常用的文本编辑器打开 Claude for Desktop 配置文件。要在您的系统中查找配置文件，请按照模型上下文协议 (Model Context Protocol) 站点上的快速入门说明进行操作。其默认位置为：
macOS：
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：
%APPDATA%\Claude\claude_desktop_config.json
将以下行添加到配置文件中，将 credentials、endpoint 和YOUR_USERNAME替换为实际值。本示例使用 Podman，但如果您使用 Docker，请将command:字段中的podman替换为docker 。如果您配置了其他 MCP 服务器，只需在列表中插入 AIStor 配置即可。
添加--allow-*标志时请务必小心。默认情况下，如果未添加任何标志，服务器将以只读模式运行。仅在需要时才将--allow-write和--allow-delete标志添加到此配置中。-- --allow-admin标志用于启用收集集群信息的管理功能。
默认情况下，服务器列出并发送到 LLM 的对象或存储桶数量限制为 1000 个。这样做是为了避免达到模型上下文窗口（以令牌为单位）的限制。如果您的模型允许更宽的上下文窗口，您可以通过在配置文件中添加--max-keys参数来增加此数量。请记住，每个对象记录包含数十个令牌。
用法
以下是您可以执行的操作的一些示例：
基本操作
“列出我的 AIStor 服务器上的所有存储桶”
“列出桶测试的内容”
文件操作
“将文件 example.pdf 下载到我的下载目录”
“创建一个存储桶 my-bucket”
“将 document.pdf 从下载上传到存储桶 my-bucket”
元数据操作
“获取存储桶 my-bucket 中 file.pdf 的元数据”
“列出对象 config.json 的所有标签”
管理员操作
“显示服务器健康状态”
“获取存储使用情况统计信息”
每个命令都会返回包含相关信息的人类可读的响应。
可用工具
通常，大型语言模型 (LLM) 能够确定要使用哪个工具来处理您的请求。有时，您可能需要明确告知模型要使用哪个工具。针对这种情况，也为了让您了解此 MCP 服务器还有哪些其他功能，以下是此版本中可用的工具列表。
您可以随时通过单击 Claude for Desktop 应用程序中的锤子图标来获取此列表。
ask-object ：使用 AI 询问有关对象内容的问题，支持各种文件格式并返回上下文答案
copy-object ：将对象从一个存储桶复制到另一个存储桶，同时保留元数据并根据需要修改属性。您还可以指定版本 ID 来复制对象的特定版本。
create-bucket ：使用指定的配置和可选的版本控制设置创建一个新的 bucket
delete-bucket ：删除存储桶并选择性地强制删除其包含的所有对象
delete-object ：从存储桶中删除特定对象或版本，并可选地支持软删除。您还可以指定版本 ID 来删除对象的特定版本。
download-object ：将对象从指定的存储桶下载到本地文件系统，并保留元数据。您还可以指定版本 ID 来下载对象的特定版本。
get-admin-info ：获取有关 AIStor 对象存储的全面技术信息，包括状态、性能指标和配置
get-bucket-lifecycle ：获取指定 bucket 的生命周期（也称为生命周期规则，也称为 ILM 配置）
get-bucket-replication ：获取指定 bucket 的复制配置
get-bucket-tags ：获取指定 bucket 的标签
get-bucket-versioning ：获取指定 bucket 的版本控制状态和配置
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 ：将文件从本地文件系统上传到指定的存储桶，支持元数据和标签