AIStor
Official MCP server for AIStor
What is AIStor?
AIStor is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to official mcp server for aistor
Official MCP server for AIStor
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Official MCP server for AIStor
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx aistorConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use AIStor
The AIStor MCP Server is the official MinIO integration that connects AI assistants to AIStor object storage, enabling natural-language management of buckets, objects, and cluster administration. It supports listing and navigating buckets, uploading and downloading files, retrieving presigned URLs, querying AI-powered insights about object content, and monitoring cluster health. Teams running AIStor on-premises or in the cloud can use this server to automate data workflows and query stored assets without writing custom code.
Prerequisites
- Docker or Podman installed and running on your machine
- A running AIStor (MinIO) instance with a known endpoint URL
- AIStor access key and secret key with appropriate permissions
- An MCP-compatible client such as Claude Desktop
Obtain AIStor credentials
Log into your AIStor console and create or copy an access key and secret key pair. Note the endpoint URL (e.g., https://play.min.io) and whether SSL is enabled.
Pull the AIStor MCP server image
Pull the official container image from the MinIO registry using Podman or Docker.
podman pull quay.io/minio/aistor/mcp-server-aistor:latestConfigure Claude Desktop
Add the AIStor MCP server to your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json. Replace the placeholder values with your actual endpoint and credentials.
{
"mcpServers": {
"aistor": {
"command": "podman",
"args": [
"run", "-i", "--rm",
"-v", "/Users/YOUR_USERNAME/Downloads:/Downloads",
"-e", "MINIO_ENDPOINT=your-aistor-endpoint",
"-e", "MINIO_ACCESS_KEY=your-access-key",
"-e", "MINIO_SECRET_KEY=your-secret-key",
"-e", "MINIO_USE_SSL=true",
"quay.io/minio/aistor/mcp-server-aistor:latest"
]
}
}
}Enable write and admin operations (optional)
By default the server runs in read-only mode. Pass --allow-write to enable bucket and object creation, --allow-delete for deletion, and --allow-admin for cluster administration functions. Add these flags to the args array after the image name.
"--allow-write", "--allow-delete", "--allow-admin"Restart Claude Desktop and verify
Quit and reopen Claude Desktop. A hammer icon should appear in the chat interface confirming the AIStor tools are loaded. Type 'List my buckets' to confirm connectivity.
AIStor Examples
Client configuration
Full claude_desktop_config.json snippet for read-only AIStor access via Podman.
{
"mcpServers": {
"aistor": {
"command": "podman",
"args": [
"run", "-i", "--rm",
"-v", "/Users/yourname/Downloads:/Downloads",
"-e", "MINIO_ENDPOINT=https://play.min.io",
"-e", "MINIO_ACCESS_KEY=minioadmin",
"-e", "MINIO_SECRET_KEY=minioadmin",
"-e", "MINIO_USE_SSL=true",
"quay.io/minio/aistor/mcp-server-aistor:latest"
]
}
}
}Prompts to try
Example natural-language prompts that exercise AIStor MCP tools.
- "List all buckets on my AIStor server"
- "Show me the objects in the bucket named 'reports' with their sizes"
- "Download example.pdf from bucket 'documents' to my Downloads folder"
- "Get a presigned URL for file.csv in bucket 'data' valid for 1 hour"
- "Show the health status and storage usage of the cluster"Troubleshooting AIStor
Connection refused or endpoint not reachable
Verify the MINIO_ENDPOINT value includes the correct protocol and port (e.g., https://play.min.io:9000). If running AIStor locally, ensure the container network can reach the host using host.docker.internal instead of localhost.
Access denied errors when listing or uploading
The access key must have the appropriate MinIO policy attached. For write operations the --allow-write flag must also be present in the container args. Check the key's permissions in the AIStor console under Identity > Access Keys.
Files downloaded to an unexpected location
The -v mount in the Podman args maps a host directory to /Downloads inside the container. Ensure the path on the left side of the colon matches a directory that exists on your machine and that you have write permission to it.
Frequently Asked Questions about AIStor
What is AIStor?
AIStor is a Model Context Protocol (MCP) server that official mcp server for aistor It connects AI assistants to external tools and data sources through a standardized interface.
How do I install AIStor?
Follow the installation instructions on the AIStor GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with AIStor?
AIStor works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is AIStor free to use?
Yes, AIStor is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
AIStor Alternatives — Similar Cloud Services Servers
Looking for alternatives to AIStor? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务,帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up AIStor in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use AIStor?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.