MCP.so
Sign In

AIStor MCP server

@minio

Repository

About AIStor MCP server

Official MCP Server for AIStor

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

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.

Frequently asked questions

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

Basic information

Category

Other

Transports

stdio

Author

minio

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K