home / mcp / aistor mcp server

AIStor MCP Server

Official MCP Server for AIStor

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "minio-mcp-server-aistor": {
      "url": "http://localhost:8090/mcp",
      "headers": {
        "MINIO_USE_SSL": "true",
        "MINIO_ENDPOINT": "https://play.min.io",
        "MINIO_ACCESS_KEY": "minioadmin",
        "MINIO_SECRET_KEY": "minioadminpass"
      }
    }
  }
}

You can deploy and use this MCP server to interact with AIStor object stores, enabling guided, AI-assisted operations such as listing buckets, describing object contents, uploading data, and managing metadata with secure admin controls.

How to use

You interact with the AIStor MCP server through an MCP-enabled client. Start by configuring a connection to either a remote MCP endpoint or a local, containerized server that exposes the MCP interface. Once connected, you can list buckets and objects, fetch metadata and tags, generate presigned URLs for objects, describe object contents with AI assistance, and perform write and delete actions if you have the proper permissions. Admin commands let you inspect server health and storage usage.

How to install

Prerequisites: you need Docker or Podman installed on your workstation, plus access credentials for an AIStor MinIO-compatible object store (MINIO_ENDPOINT, MINIO_ACCESS_KEY, MINIO_SECRET_KEY). The MCP server runs inside a container and can be configured for HTTP transport or STDIO transport depending on your client.

Additional setup and notes

Configuration for both Claude desktop clients and StreamableHTTP-enabled clients is provided below. By default, the MCP server runs in read-only mode unless you explicitly enable write, delete, and admin capabilities with the appropriate flags. Review the examples to tailor the server behavior to your security and workflow requirements.

Available tools

ask_object

Ask questions about an object's content using AI, supporting various file formats and returning contextual answers

copy_object

Copy an object from one bucket to another while preserving metadata and optionally modifying properties. You can also specify a version ID to copy a specific version of the object.

create_bucket

Create a new bucket with specified configurations and optional versioning settings

delete_bucket

Delete a bucket and optionally force removal of all contained objects

delete_object

Delete a specific object or version from a bucket, with optional soft delete support. You can also specify a version ID to delete a specific version of the object.

download_object

Download an object from a specified bucket to the local filesystem, preserving metadata. You can also specify a version ID to download a specific version of the object.

get_admin_info

Get comprehensive technical information about the AIStor object store, including status, performance metrics, and configuration

get_bucket_lifecycle

Get the lifecycle rules (ILM) of a specified bucket

get_bucket_replication

Get the replication configuration of a specified bucket

get_bucket_tags

Get the tags of a specified bucket

get_bucket_versioning

Get the versioning status and configuration of a specified bucket

get_data_usage_info

Get data usage information for the AIStor object store, including totals and per-bucket usage

get_object_metadata

Get detailed metadata of an object including content type, size, and headers

get_object_presigned_url

Get a presigned URL for an object with an optional expiration time (default 7 days)

get_object_tags

Get all tags associated with a specific object in a bucket

get_object_versions

Get all versions of an object in a bucket

list_allowed_directories

List all directories permitted for server operations

list_bucket_contents

List all objects in a bucket with details; supports filtering by prefix and versions

list_buckets

List all buckets with basic information

move_object

Move an object between buckets by copying to destination and removing from source, with optional version handling

set_bucket_tags

Set tags for a specified bucket

set_bucket_versioning

Configure versioning for a bucket with admin privileges

set_object_tags

Set or update tags for an object, supporting multiple key-value pairs and optional versioning

text_to_object

Convert text to an object in a bucket, with support for different content types

upload_object

Upload a file from local filesystem to a specified bucket