AIStor MCP server

Name: AIStor MCP server
Author: minio

@minio

Repository

About AIStor MCP server

Official MCP Server for AIStor

#mcp-server #object-storage #ai-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aistor": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/Users/YOUR_USERNAME/Downloads:/Downloads",
        "-e",
        "MINIO_ENDPOINT=REPLACE_WITH_ENDPOINT",
        "-e",
        "MINIO_ACCESS_KEY=REPLACE_WITH_ACCESS_KEY",
        "-e",
        "MINIO_SECRET_KEY=REPLACE_WITH_SECRET_KEY",
        "-e",
        "MINIO_USE_SSL=true",
        "quay.io/minio/aistor/mcp-server-aistor:latest",
        "--allowed-directories",
        "/Downloads",
        "--allow-write",
        "--allow-delete",
        "--allow-admin"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is AIStor MCP server?

AIStor MCP server is a Model Context Protocol (MCP) server that provides a set of tools for Large Language Models (LLMs) to interact with AIStor or MinIO object stores. It enables read, write, delete, and admin operations through natural language commands.

How to use AIStor MCP server?

Configure the server in your MCP client (e.g., Claude for Desktop) using STDIO transport with a Docker/Podman command, or StreamableHTTP transport with an HTTP endpoint. Set environment variables for MinIO endpoint, access key, and secret key. Use command‑line flags like --allow-write, --allow-delete, and --allow-admin to enable additional operations. See the README for detailed JSON configuration examples.

Key features of AIStor MCP server

List buckets and objects with metadata and tags
Describe object contents using AI (ask_object tool)
Upload, download, copy, and move objects
Create and delete buckets with versioning support
Admin functions: cluster info, storage usage, health
Text-to-object conversion (text_to_object tool)

Use cases of AIStor MCP server

Managing object store buckets and objects via natural language
Retrieving object metadata and generating presigned URLs from an LLM
Automating administrative tasks like cluster health checks
Uploading files from a local downloads directory to a bucket

FAQ from AIStor MCP server

What are the prerequisites to use AIStor MCP server?

You need Docker or Podman, AIStor or MinIO credentials (access key, secret key), and the endpoint URL. For testing you can use the MinIO Playground server.

How do I enable write or delete operations?

By default the server runs in read‑only mode. Add --allow-write and --allow-delete flags to the configuration to enable those operations. Use --allow-admin for admin functions.