MinIO MCP 配置教程

简介

MinIO MCP 是一个 Model Context Protocol 服务器，让 AI 助手可以直接操作 MinIO 对象存储，包括上传、下载、列出文件等操作。

安装配置

Kiro IDE 配置

在项目根目录创建 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "minio": {
      "command": "npx",
      "args": ["-y", "mcp-minio"],
      "env": {
        "MINIO_ENDPOINT": "你的MinIO服务器IP",
        "MINIO_PORT": "9000",
        "MINIO_SSL": "false",
        "MINIO_ACCESS_KEY": "你的AccessKey",
        "MINIO_SECRET_KEY": "你的SecretKey"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

环境变量说明

可用工具

配置成功后，AI 助手可以使用以下工具：

1. getBuckets - 列出所有存储桶

返回所有 bucket 的名称和创建时间

2. listFiles - 列出文件

参数：bucketName (必填)
返回指定 bucket 中的所有文件列表

3. getFileContent - 获取文件内容

参数：bucketName, objectName (必填)
返回文件的文本内容

4. getFileUrl - 获取文件下载链接

参数：bucketName, objectName (必填)
返回预签名的下载 URL（默认7天有效）

5. uploadFile - 上传文件

参数：bucketName, objectName, buffer (必填)
buffer 为 Base64 编码的文件内容

6. createBucket - 创建存储桶

参数：bucketName (必填)
创建新的存储桶

使用示例

列出所有 bucket

让 AI 执行：列出 MinIO 中所有的 bucket

上传文件

让 AI 执行：把 xxx.txt 文件上传到 mybucket

生成下载脚本

让 AI 执行：生成一个 PowerShell 脚本，下载 album bucket 中的 xxx.zip 到 D 盘

实际案例：一键安装脚本

我们用 MinIO MCP 创建了一个开发工具安装脚本：

# Windows PowerShell 一键安装 Tomcat + Maven
irm http://106.12.107.176:19000/album/install-dev-tools.ps1 | iex

这个脚本会：

1. 下载 Apache Tomcat 9.0.105
2. 下载 Apache Maven 3.9.9
3. 解压到 D 盘根目录
4. 自动清理临时文件

故障排查

连接失败

1. 检查 MinIO 服务是否运行：

curl http://你的IP:端口/minio/health/live

2. 检查凭证是否正确：

# 使用 mc 客户端测试
mc alias set myminio http://IP:PORT ACCESS_KEY SECRET_KEY
mc ls myminio

npx 安装失败

清理 npm 缓存后重试：

npm cache clean --force
npx -y mcp-minio

相关链接

• npm 包：https://www.npmjs.com/package/mcp-minio
• GitHub：https://github.com/aevsai/mcp-minio

创建时间：2024-12-28