MinIO Model-Context Protocol (MCP)
2025.03.21
0
Python对象存储AI集成标准化接口数据库开发效率
MinIO Model-Context Protocol (MCP) 是一个为MinIO对象存储实现的模型上下文协议服务器和客户端。它提供了一种标准化的方式来与MinIO进行交互，支持多种文件类型的访问和管理，包括文本文件和二进制文件。该项目还集成了Anthropic的Claude模型，实现AI驱动的MinIO交互。
View on GitHub
Overview
基本能力
产品定位
MinIO MCP 是一个为MinIO对象存储提供标准化交互接口的协议实现，旨在简化与MinIO的交互过程，支持多种客户端实现和AI集成。
核心功能
- 资源访问：
- 文本文件（自动检测文件扩展名）
- 二进制文件（作为application/octet-stream处理）
-
存储桶内容（每个存储桶最多1000个对象）
-
工具列表：
- ListBuckets：返回认证请求者拥有的所有存储桶列表。
- 可选参数：
start_after（分页），max_buckets（限制结果）
- 可选参数：
- ListObjects：返回存储桶中的部分或全部（最多1,000个）对象。
- 必需参数：
bucket_name - 可选参数：
prefix（按前缀过滤），max_keys（限制结果）
- 必需参数：
- GetObject：从MinIO检索对象。
- 必需参数：
bucket_name，object_name
- 必需参数：
- PutObject：使用fput方法将文件上传到MinIO存储桶。
- 必需参数：
bucket_name，object_name，file_path
- 必需参数：
适用场景
- 需要与MinIO对象存储进行标准化交互的开发项目。
- 需要AI驱动交互的MinIO数据管理场景。
- 需要集成多种客户端实现的MinIO应用。
使用教程
使用依赖
- 克隆仓库：
git clone https://github.com/yourusername/minio-mcp.git
cd minio-mcp
- 安装依赖：
pip install -r requirements.txt
或使用uv：
uv pip install -r requirements.txt
安装教程
- 创建
.env文件并配置：
# MinIO Configuration
MINIO_ENDPOINT=play.min.io
MINIO_ACCESS_KEY=your_access_key
MINIO_SECRET_KEY=your_secret_key
MINIO_SECURE=true
MINIO_MAX_BUCKETS=5
# Server Configuration
SERVER_HOST=0.0.0.0
SERVER_PORT=8000
# For Anthropic Client (if using)
ANTHROPIC_API_KEY=your_anthropic_api_key
- 运行服务器：
python src/minio_mcp_server/server.py
调试方式
使用MCP Inspector进行调试：
npx @modelcontextprotocol/inspector python path/to/minio-mcp/src/minio_mcp_server/server.py
常见问题解答
- 如何配置Anthropic客户端？
在
src/client/servers_config.json中配置服务器信息。 - 如何集成到Claude Desktop？ 在Claude Desktop的配置文件中添加MCP服务器配置。
- 如何调试MCP服务器？ 使用MCP Inspector工具进行调试。