MinIO Storage MCP

🗄️ 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 小时的下载链接

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

🛠️ 可用工具

连接管理

connect_minio - 连接到 MinIO 服务器

存储桶操作

list_buckets - 列出所有存储桶
create_bucket - 创建存储桶
delete_bucket - 删除存储桶
bucket_exists - 检查存储桶是否存在

对象操作

list_objects - 列出存储桶中的对象
upload_file - 上传文件
download_file - 下载文件
delete_object - 删除对象
copy_object - 复制对象
get_object_info - 获取对象信息

批量操作

upload_files - 批量上传文件
download_files - 批量下载文件
delete_objects - 批量删除对象

权限管理

set_bucket_policy - 设置存储桶策略
get_bucket_policy - 获取存储桶策略
delete_bucket_policy - 删除存储桶策略

其他功能

generate_presigned_url - 生成预签名 URL
get_storage_stats - 获取存储统计信息

🔧 技术架构

语言: TypeScript
MCP SDK: @modelcontextprotocol/sdk
MinIO 客户端: minio
类型验证: zod
Node.js 版本: >= 18.0.0

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目采用 MIT 许可证。

📞 联系方式

如有问题或建议，欢迎联系：

微信: pickstar_loveXX

⭐ 如果这个项目对您有帮助，请给个 Star！

Deploy Server

HTTP connection URL

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

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.

Related MCP Servers

MinIO Model-Context Protocol (MCP) Server
ucesys
-
security
A
license
-
quality
Provides a standardized way to interact with MinIO object storage, allowing access to text files, binary files, and bucket contents while supporting operations like listing buckets/objects, retrieving objects, and uploading files.
Last updated -
3
MIT License
cloudinary-mcp-server
yoavniran
A
security
A
license
A
quality
A Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.
Last updated -
5
531
MIT License
Storacha MCP Storage Serverofficial
storacha
-
security
A
license
-
quality
Enables AI applications to interact with decentralized storage through a standardized Model Context Protocol interface, allowing file uploads, retrievals, and identity management.
Last updated -
11
Apache 2.0
DP-MCP Server
devraj21
-
security
F
license
-
quality
A comprehensive Data Platform server that enables seamless integration between PostgreSQL databases and MinIO object storage, with AI-powered natural language query capabilities.
Last updated -

View all related MCP servers

Appeared in Searches

How to copy files to a directory