MCP.so
Sign In

AIStor MCP server

@minio

About AIStor MCP server

Official MCP Server for AIStor

Basic information

Category

Other

Transports

stdio

Publisher

minio

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.

Can I limit the number of objects listed?

Yes, use the --max-keys parameter. The default is 1000 objects to avoid exceeding the model’s context window.

What transport protocols does the server support?

It supports STDIO transport (for Claude for Desktop) and StreamableHTTP (for clients like Cherry Studio).

Is it compatible with MinIO?

Yes, it works with any S3‑compatible object store, including MinIO and AIStor. You can use MinIO Playground for testing.

Comments

More Other MCP servers