🗄️ 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！