Minio MCP Service

MinIO 模型上下文协议（MCP）

本项目为 MinIO 对象存储实现了模型上下文协议（MCP）服务和客户端，提供与 MinIO 交互的标准化方式。

功能

服务端

资源

通过 资源 暴露 MinIO 数据。服务端可以访问并提供：

• 文本文件（根据文件扩展名自动检测）
• 二进制文件（作为 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

客户端

本项目包含多种客户端实现：

1. 基础客户端 - 用于直接与 MinIO MCP 服务交互的简易客户端
2. Anthropic 客户端 - 集成 Anthropic 的 Claude 模型，实现由 AI 驱动的 MinIO 交互

安装

1. 克隆仓库：

git clone https://github.com/yourusername/minio-mcp.git
cd minio-mcp

2. 使用 pip 安装依赖：

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

使用基础客户端

from src.client import main
import asyncio

asyncio.run(main())

使用 Anthropic 客户端

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

{
  "mcpServers": {
    "minio_service": {
      "command": "python",
      "args": ["path/to/minio_mcp_server/server.py"]
    }
  }
}

2. 运行客户端：

python src/client/mcp_anthropic_client.py

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

{
  "mcpServers": {
    "minio-mcp": {
      "command": "python",
      "args": [
        "path/to/minio-mcp/src/minio_mcp_server/server.py"
      ]
    }
  }
}

开发

项目结构

minio-mcp/
├── src/
│   ├── client/                  # Client implementations
│   │   ├── mcp_anthropic_client.py  # Anthropic integration
│   │   └── servers_config.json  # Server configuration
│   ├── minio_mcp_server/        # MCP server implementation
│   │   ├── resources/           # Resource implementations
│   │   │   └── minio_resource.py  # MinIO resource
│   │   └── server.py            # Main server implementation
│   ├── __init__.py
│   └── client.py                # Basic client implementation
├── LICENSE
├── pyproject.toml
├── README.md
└── requirements.txt

运行测试

pytest

代码格式化

black src/
isort src/
flake8 src/

调试

由于 MCP 服务通过 stdio 运行，调试可能颇具挑战。为获得最佳调试体验，我们建议使用 MCP Inspector：

npx @modelcontextprotocol/inspector python path/to/minio-mcp/src/minio_mcp_server/server.py

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。