drio
Open app

Minio MCP Service

Source

Exposes MinIO data through Resources. The server can access and provide: Text files (automatically detected based on file extension) Binary files (handled as application/octet-stream) Bucket contents (up to 1000 objects per bucket) Tools ListBuckets Returns a list of all buckets owned by the authenticated sender of the request Optional parameters: start_after (pagination), max_buckets (limit results) ListObjects Returns some or all (up to 1,000) of the objects in a bucket with each request Required parameter: bucket_name Optional parameters: prefix (filter by prefix), max_keys (limit results) GetObject Retrieves an object from MinIO Required parameters: bucket_name, object_name PutObject Uploads a file to MinIO bucket using fput method Required parameters: bucket_name, object_name, file_path

Catalog onlyCatalog onlySTDIO

Overview

Minio MCP Service is a server and client implementation for the Model-Context Protocol (MCP) that allows standardized interaction with MinIO object storage, enabling access to various data types and bucket contents.

To use the Minio MCP Service, clone the repository, install the dependencies, configure the environment, and run the server. You can interact with the server using either the Basic Client or the Anthropic Client for AI-powered interactions.

  • Exposes MinIO data through Resources, including text and binary files. - Provides tools for listing buckets and objects, retrieving, and uploading files. - Supports multiple client implementations for different interaction methods.
  1. Managing and accessing object storage in MinIO.
  2. Integrating with AI models for enhanced data interaction.
  3. Facilitating data retrieval and upload operations in cloud applications.

Add to your AI client

Use these steps to connect Minio MCP Service in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "minio-python-mcp-ucesys": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "minio-python-mcp-ucesys": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "minio-python-mcp-ucesys": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "minio-python-mcp-ucesys": {
      "type": "stdio",
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "minio-python-mcp-ucesys": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "minio-python-mcp-ucesys": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/PycharmProjects/minio-mcp/src/minio_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

FAQ

What types of files can be accessed?

The service can access text files and binary files.

How do I run the server?

You can run the server using the command: `python src/minio_mcp_server/server.py`.

Is there a client for AI interactions?

Yes, there is an Anthropic Client that integrates with Claude models for AI-powered interactions.

Cloud storage