MCP 服务器

MinIO Storage MCP

Enables AI assistants to manage MinIO object storage through comprehensive bucket operations, file uploads/downloads, batch processing, permissions management, and URL generation. Supports both automatic and manual connection modes with flexible authentication options.

README

🗄️ MinIO MCP

一个功能完善的 MinIO 对象存储管理 MCP（Model Context Protocol）工具，让您通过 AI 助手轻松管理 MinIO 存储服务。

✨ 功能特性

🔗 连接管理

✅ 连接到 MinIO 服务器
✅ 支持 SSL/非SSL 连接
✅ 灵活的认证配置
✅ 支持命令行参数自动连接

🗂️ 存储桶管理

✅ 创建、删除存储桶
✅ 列出所有存储桶
✅ 检查存储桶是否存在
✅ 存储桶策略管理

📁 文件操作

✅ 上传单个文件或批量上传
✅ 下载单个文件或批量下载
✅ 删除单个对象或批量删除
✅ 复制对象
✅ 获取对象详细信息

🔐 权限管理

✅ 设置存储桶访问策略
✅ 查看当前策略配置
✅ 删除策略设置

🔗 URL 生成

✅ 生成预签名 URL（GET/PUT/DELETE）
✅ 自定义过期时间
✅ 支持临时访问链接

📊 统计信息

✅ 查看存储使用统计
✅ 各存储桶详细信息
✅ 对象数量和大小统计

🚀 快速开始

安装

npm install -g @pickstar-2002/minio-mcp@latest

在 IDE 中配置

方式一：直接在 args 中传递连接参数（推荐）

Cursor IDE / CodeBuddy

{
  "mcpServers": {
    "minio-mcp": {
      "command": "npx",
      "args": [
        "@pickstar-2002/minio-mcp@latest",
        "--endpoint=localhost",
        "--port=9000",
        "--access-key=minioadmin",
        "--secret-key=minioadmin",
        "--use-ssl=false"
      ]
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "minio-mcp": {
      "command": "npx",
      "args": [
        "@pickstar-2002/minio-mcp@latest",
        "--endpoint=your-minio-server.com",
        "--port=9000",
        "--access-key=your-access-key",
        "--secret-key=your-secret-key",
        "--use-ssl=true",
        "--region=us-east-1"
      ]
    }
  }
}

方式二：使用环境变量

{
  "mcpServers": {
    "minio-mcp": {
      "command": "npx",
      "args": ["@pickstar-2002/minio-mcp@latest"],
      "env": {
        "MINIO_ENDPOINT": "localhost",
        "MINIO_PORT": "9000",
        "MINIO_USE_SSL": "false",
        "MINIO_ACCESS_KEY": "your-access-key",
        "MINIO_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

🔧 命令行参数说明

参数	说明	示例	必需
`--endpoint`	MinIO 服务器地址	`--endpoint=localhost`	✅
`--port`	MinIO 服务器端口	`--port=9000`	❌ (默认9000)
`--access-key`	访问密钥	`--access-key=minioadmin`	✅
`--secret-key`	秘密密钥	`--secret-key=minioadmin`	✅
`--use-ssl`	是否使用SSL	`--use-ssl=true`	❌ (默认false)
`--region`	区域设置	`--region=us-east-1`	❌

📖 使用指南

自动连接模式

当您在配置中提供了完整的连接参数时，MCP 服务器会自动连接到 MinIO 服务器，您可以直接开始使用：

# 直接开始操作，无需手动连接
请列出所有存储桶

# 创建存储桶
请创建一个名为 "my-documents" 的存储桶

# 上传文件
请将本地文件 "/path/to/file.pdf" 上传到 "my-documents" 存储桶中

手动连接模式

如果没有提供连接参数，您需要先手动连接：

请帮我连接到 MinIO 服务器，地址是 localhost:9000，访问密钥是 minioadmin，秘密密钥是 minioadmin

基本操作示例

# 列出对象
请列出 "my-documents" 存储桶中的所有对象

# 下载文件
请从 "my-documents" 存储桶下载 "documents/file.pdf" 到本地 "/path/to/download/file.pdf"

# 生成预签名 URL
请为 "my-documents/documents/file.pdf" 生成一个有效期为 1 小时的下载链接

# 获取存储统计
请显示存储使用统计信息