Minio MCP Server Aistor

🚀 AIStor MCP Server Guide

AIStor MCP Server Guide provides a detailed introduction to the operation of the AIStor server based on the Model Context Protocol (MCP). It includes functionalities, configuration steps, and usage examples.

🚀 Quick Start

Configuration

1. Environment Variables:

# Example environment variable configuration
export MINIO_ENDPOINT=minio.example.com:9000
export MINIO_ACCESS_KEY=your_access_key
export MINIO_SECRET_KEY=your_secret_key

2. Installation and Startup:
   • Install: Download and install the AIStor MCP server.
   • Configure: Edit the configuration file to set the storage path and access permissions.
   • Start the Service: Use the command ./ai-stor-mcp start to start the service.

Usage Examples

Example 1: List All Buckets

# List all buckets
list-buckets

# Example output:
Bucket1
Bucket2

Example 2: Upload a File

upload-object --bucket my-bucket --file local-file.txt --metadata "key=value"

✨ Features

Read Operations

• List Buckets: Retrieve all buckets in the AIStor storage.
• List Bucket Contents: Get all objects in a specific bucket along with their detailed information (size, last modification time, etc.).
• Download Object: Download an object from a specified bucket to the local file system while preserving metadata.

AI Operations

• Query Object Content: Analyze the content of an object using AI and generate context-aware answers, supporting multiple file formats.

Write Operations

• Create Bucket: Create a new bucket with specified configurations, allowing version control settings.
• Upload Object: Upload a file from the local file system to a specified bucket, supporting metadata and tags.

Delete Operations

• Delete Bucket: Delete a specified bucket and its contents (optional).
• Delete Object: Delete a specific object or its specified version.

Management Functions

• Get Bucket Lifecycle Rules: View the lifecycle configuration of a bucket.
• Get Bucket Replication Configuration: Check the replication settings of a bucket.
• Get Bucket Tags: Retrieve all tag information of a bucket.
• Get Bucket Versioning Status: Understand the versioning enablement and configuration of a bucket.

Other Functions

• Get Storage Usage: Calculate the data volume, number of objects, and usage of each bucket in the entire AIStor storage.
• Get Object Metadata: View detailed metadata information (content type, size, etc.) of a specific object.
• Get Object Signed URL: Generate an object access link with an expiration time, defaulting to 7 days.

📦 Installation

Environment Variable Configuration

# Example environment variable configuration
export MINIO_ENDPOINT=minio.example.com:9000
export MINIO_ACCESS_KEY=your_access_key
export MINIO_SECRET_KEY=your_secret_key

Installation and Startup Steps

1. Download and install the AIStor MCP server.
2. Edit the configuration file to set the storage path and access permissions.
3. Start the service using the command ./ai-stor-mcp start.

💻 Usage Examples

Example 1: List All Buckets

# List all buckets
list-buckets

# Example output:
Bucket1
Bucket2

Example 2: Upload a File

upload-object --bucket my-bucket --file local-file.txt --metadata "key=value"

📚 Documentation

Available Tools and Their Functions

• Query Object Content: Analyze the content of a specific object using AI, supporting multiple file formats, and return context-related answers.
• Copy Object: Copy an object from one bucket to another, preserving metadata and allowing custom attributes. Supports copying by specifying a version ID.
• Create Bucket: Create a new bucket with specified configurations, allowing version control options.
• Delete Bucket: Delete a specified bucket and its contents (optional).
• Delete Object: Delete a specific object or its specified version. Supports soft delete and can specify the exact object version to delete by version ID.
• Get Storage Information: Obtain comprehensive technical information about the AIStor object storage, including running status, performance metrics, and configuration details.
• Get Bucket Lifecycle Rules: View the lifecycle rules (also known as ILM configuration) of a specified bucket.
• Get Bucket Replication Configuration: Check the replication settings of a specified bucket.
• Get Bucket Tags: Retrieve all tag information of a specific bucket.
• Get Bucket Versioning Status: Understand the versioning enablement and detailed configuration of a bucket.
• Get Data Usage: Calculate the data volume, number of objects, and specific usage of each bucket in the entire AIStor storage.
• Get Object Metadata: View detailed metadata information of a specific object, including content type, size, custom headers, and system attributes.
• Get Object Signed URL: Generate an access link for a specified object with an expiration time, defaulting to 7 days.
• Get Object Tags: Retrieve all associated tag information of a specific object.
• Get Object Version List: View all available versions of a specified object.
• List Allowed Directories: List all local directories authorized for operations.
• List Bucket Contents: Retrieve all objects in a specific bucket along with their detailed information (size, last modification time, etc.).
• Upload Object: Upload a file from the local file system to a specified bucket, supporting custom metadata and tags.