MinIO Model-Context Protocol (MCP) Server

MinIO 模型上下文协议 (MCP)

该项目为 MinIO 对象存储实现了模型上下文协议 (MCP) 服务器和客户端。它提供了一种与 MinIO 交互的标准化方式。

特征

服务器

资源

通过Resources公开 MinIO 数据。服务器可以访问并提供：

• 文本文件（根据文件扩展名自动检测）
• 二进制文件（作为应用程序/八位字节流处理）
• 存储桶内容（每个存储桶最多 1000 个对象）

工具

• 列表桶
  • 返回经过身份验证的请求发送者所拥有的所有存储桶的列表
  • 可选参数： start_after （分页）、 max_buckets （限制结果）
• 列表对象
  • 每次请求返回存储桶中的部分或全部对象（最多 1,000 个）
  • 必需参数： bucket_name
  • 可选参数： prefix （按前缀过滤）、 max_keys （限制结果）
• 获取对象
  • 从 MinIO 中检索对象
  • 必需参数： bucket_name 、 object_name
• 放置对象
  • 使用 fput 方法将文件上传到 MinIO bucket
  • 必需参数： bucket_name 、 object_name 、 file_path

客户

该项目包括多个客户端实现：

1. 基本客户端- 用于与 MinIO MCP 服务器直接交互的简单客户端
2. Anthropic Client - 与 Anthropic 的 Claude 模型集成，实现与 MinIO 的 AI 交互

安装

1. 克隆存储库：

2. 使用 pip 安装依赖项：

或者使用 uv：

环境配置

在根目录中创建一个.env文件，其配置如下：

用法

运行服务器

可以直接运行服务器：

使用基本客户端

使用 Anthropic 客户端

1. 在src/client/servers_config.json中配置服务器：

2. 运行客户端：

3. 与助手互动：
   • 助手将自动检测可用的工具
   • 您可以询问有关 MinIO 数据的问题
   • 助手将使用适当的工具来检索信息
4. 退出会话：
   • 输入quit或exit结束会话

与 Claude Desktop 集成

您可以将此 MCP 服务器与 Claude Desktop 集成：

配置

在 MacOS 上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

发展

项目结构

运行测试

代码格式化

调试

由于 MCP 服务器通过 stdio 运行，调试起来可能比较困难。为了获得最佳调试体验，我们建议使用 MCP 检查器：

启动后，检查器将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。