mcp-server-opendal MCP Server

Use This MCP server To

Access and list files from multiple cloud storage providers Read and retrieve file contents from S3, Azure, or Google Cloud Storage Integrate cloud storage data into AI model context workflows Configure storage access dynamically using environment variables Enable LLMs to query and interact with remote storage files Aggregate data from diverse storage backends for analysis Support multi-cloud storage environments with a single MCP server

README

Model Context Protocol Server for Apache OpenDAL™

A Model Context Protocol (MCP) server implementation that provides access to various storage services via Apache OpenDAL™.

Features

Seamless access to multiple storage services including S3, Azure Blob Storage, Google Cloud Storage, and more
List files and directories from storage services
Read file contents with automatic text/binary detection
Environment variable based configuration

Installation

pip install mcp-server-opendal

Usage with Claude Desktop

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "opendal": {
      "command": "uvx",
      "args": [
        "mcp-server-opendal"
      ],
      "env": {
        "YOUR_ENV_VAR": "YOUR_ENV_VALUE"
      }
    }
  }
}

It requires uv to be installed on your machine. Check the official documentation for installation guides.

Environment variables

Configure storage services by setting environment variables. Each service requires a prefix and specific configuration options.

For example, to configure an S3 service with alias "mys3":

OPENDAL_MYS3_TYPE=s3
OPENDAL_MYS3_BUCKET=mybucket
OPENDAL_MYS3_REGION=us-east-1
OPENDAL_MYS3_ENDPOINT=http://localhost:9000
OPENDAL_MYS3_ACCESS_KEY_ID=myaccesskey
OPENDAL_MYS3_SECRET_ACCESS_KEY=mysecretkey

Then you can use tool like read and list with mys3://path/to/file.

mcp-server-opendal will also load from .env.

Development

npx @modelcontextprotocol/inspector \
  uv run mcp-server-opendal

mcp-server-opendal FAQ

How do I configure mcp-server-opendal to access my cloud storage?

Configure access credentials and endpoints via environment variables for each supported storage service.

Can mcp-server-opendal read both text and binary files?

Yes, it automatically detects and handles text or binary file contents when reading files.

Which storage services does mcp-server-opendal support?

It supports multiple services including Amazon S3, Azure Blob Storage, Google Cloud Storage, and others via Apache OpenDAL.

How do I install mcp-server-opendal?

You can install it easily using pip with the command 'pip install mcp-server-opendal'.

Is mcp-server-opendal compatible with different LLM providers?

Yes, it works with various LLMs such as OpenAI, Anthropic Claude, and Google Gemini by exposing storage data through MCP.

Can I list directories and files using this MCP server?

Yes, it provides functionality to list files and directories from connected storage services.

Does mcp-server-opendal support multi-cloud environments?

Yes, it enables unified access to multiple cloud storage providers in a single MCP server instance.

How does mcp-server-opendal handle security for storage access?

It relies on secure environment variable configuration for credentials and follows best practices of the underlying storage services.