MinIO Model-Context Protocol (MCP) Server

MinIO模型上下文协议（MCP）

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

特性

服务器

资源

通过以下方式公开MinIO数据 资源服务器可以访问并提供：

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

工具

• 列表Buckets

- 返回请求的经过身份验证的发送方拥有的所有bucket的列表 - 可选参数： start_after （分页）， max_buckets （限制结果）

• 列表对象

- 每次请求时返回bucket中的部分或全部（最多1000个）对象 - 必需参数： bucket_name - 可选参数： prefix （按前缀过滤）， max_keys （限制结果）

• 获取对象

- 从MinIO检索对象 - 所需参数： bucket_name, object_name

• PutObject

- 使用fput方法将文件上传到MinIO bucket - 所需参数： bucket_name, object_name, file_path

客户端

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

1. 基本客户端 -与MinIO MCP服务器直接交互的简单客户端
2. 拟人客户 -与Anthropic的Claude模型集成，用于与MinIO进行人工智能交互

安装

1. 克隆存储库：

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

1. 使用pip安装依赖项：

pip install -r requirements.txt

或使用紫外线：

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"]
    }
  }
}

1. 运行客户端：

python src/client/mcp_anthropic_client.py

1. 与助手互动：

- 助手将自动检测可用工具 - 您可以询问有关MinIO数据的问题 - 助理将使用适当的工具检索信息

1. 退出会话：

- 类型 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检查器：

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

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

许可证

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