AIStor MCP server

This is a Model Context Protocol (MCP) server for interacting with AIStor object stores.

More information about MCP can be found on its official site.

More information about AIStor MCP server can be found in our blog posts:

• Introducing MCP server for AIStor
• Administrative functions of MCP server for AIStor
• MCP server for AIStor: How it works

Updates

• 2025-05-28
  • Added support for MCP version 2025-03-26
  • Added support for StreamableHTTP protocol
  • Added the text_to_object tool

Features

Read operations

• List buckets
• List objects in the bucket
• Get object's metadata and tags
• Create a presigned URL with expiration for an object

AI operations

• Describe the object's contents using the ask_object tool

Write operations

These operations should be enabled by using the --allow-write flag in the config.

• Create a bucket
• Upload an object to the bucket
• Add tags to the object

Delete operations

These operations should be enabled by using the --allow-delete flag in the config.

• Delete an object
• Delete a bucket

Admin operations

These operations should be enabled by using the --allow-admin flag in the config.

• Get cluster info (config, health status, available space) in human-readable form

Configuration for Claude for Desktop

This MCP server works with other MCP-enabled clients, but let's start with Claude. It uses the STDIO transport to interact with the server. See the next section for the instructions on configuring the server with StreamableHTTP transport.

Prerequisites

1. Download and install Claude for Desktop application from Claude. This MCP server works with other MCP-enabled clients, but let's start with Claude.

2. Make sure you have Docker or Podman installed and ready to use on your desktop/laptop.

3. Get your AIStor (or MinIO) object store credentials (MINIO_ACCESS_KEY and MINIO_SECRET_KEY) and its endpoint location. If you don't have an AIStor or MinIO server available, feel free to use the values for MinIO Playground server.

Configuration file

Open the Claude for Desktop configuration file with your favorite text editor. To find the config file in your system follow the Quickstart instructions from the Model Context Protocol site. Its default location is:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following lines to the config file, replacing the credentials, endpoint, and YOUR_USERNAME with their actual values. This example uses Podman, but if you use Docker replace podman in the command: field with docker. If you have other MCP servers configured just insert the AIStor config in the list.

Be careful when adding the --allow-* flags. By default without any flags the server will be running in read-only mode. Add --allow-write and --allow-delete flags to this configuration only when you need them. The --allow-admin flag enables admin functions that collect information about the cluster.

{
  "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-serv

... [View full README on GitHub](https://github.com/minio/mcp-server-aistor#readme)