Integrations
Provides access to MinIO object storage through standardized tools for listing buckets, listing objects, retrieving objects, and uploading files to MinIO buckets.
MinIO Model-Context Protocol (MCP)
This project implements a Model-Context Protocol (MCP) server and client for MinIO object storage. It provides a standardized way to interact with MinIO.
Features
Server
Resources
Exposes MinIO data through Resources. The server can access and provide:
- Text files (automatically detected based on file extension)
- Binary files (handled as application/octet-stream)
- Bucket contents (up to 1000 objects per bucket)
Tools
- ListBuckets
- Returns a list of all buckets owned by the authenticated sender of the request
- Optional parameters:
start_after
(pagination),max_buckets
(limit results)
- ListObjects
- Returns some or all (up to 1,000) of the objects in a bucket with each request
- Required parameter:
bucket_name
- Optional parameters:
prefix
(filter by prefix),max_keys
(limit results)
- GetObject
- Retrieves an object from MinIO
- Required parameters:
bucket_name
,object_name
- PutObject
- Uploads a file to MinIO bucket using fput method
- Required parameters:
bucket_name
,object_name
,file_path
Client
The project includes multiple client implementations:
- Basic Client - Simple client for direct interaction with the MinIO MCP server
- Anthropic Client - Integration with Anthropic's Claude models for AI-powered interactions with MinIO
Installation
- Clone the repository:
- Install dependencies using pip:
Or using uv:
Environment Configuration
Create a .env
file in the root directory with the following configuration:
Usage
Running the Server
The server can be run directly:
Using the Basic Client
Using the Anthropic Client
- Configure the servers in
src/client/servers_config.json
:
- Run the client:
- Interact with the assistant:
- The assistant will automatically detect available tools
- You can ask questions about your MinIO data
- The assistant will use the appropriate tools to retrieve information
- Exit the session:
- Type
quit
orexit
to end the session
- Type
Integration with Claude Desktop
You can integrate this MCP server with Claude Desktop:
Configuration
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development
Project Structure
Running Tests
Code Formatting
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we recommend using the MCP Inspector:
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
Provides a standardized way to interact with MinIO object storage, allowing access to text files, binary files, and bucket contents while supporting operations like listing buckets/objects, retrieving objects, and uploading files.
Related MCP Servers
- AsecurityAlicenseAqualityThis server facilitates interaction with Keboola's Storage API, enabling users to browse and manage project buckets, tables, and components efficiently through Claude Desktop.Last updated -713PythonMIT License
- -securityFlicense-qualityThis server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.Last updated -3Python
- AsecurityFlicenseAqualityEnables AI models to perform file system operations (reading, creating, and listing files) on a local file system through a standardized Model Context Protocol interface.Last updated -3JavaScript
- -security-license-qualityA Model Context Protocol server that enables large language models to upload files directly to Alibaba Cloud Object Storage Service (OSS), supporting multiple OSS configurations and specified upload directories.Last updated -1TypeScript