Apache OpenDAL MCP
A Model Context Protocol server that provides seamless access to multiple storage services including S3, Azure Blob Storage, and Google Cloud Storage through Apache OpenDAL™.
What is Apache OpenDAL MCP?
Apache OpenDAL MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides seamless access to multiple storage services including s3, azure blob storage, and google cloud storage through apache opendal™.
A Model Context Protocol server that provides seamless access to multiple storage services including S3, Azure Blob Storage, and Google Cloud Storage through Apache OpenDAL™.
This server falls under the Cloud Services and File Systems categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that provides seamless acces
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-server-for-apache-opendalConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Apache OpenDAL MCP
The MCP Server for Apache OpenDAL provides AI assistants with unified read and list access to dozens of storage backends — including AWS S3, Azure Blob Storage, Google Cloud Storage, local filesystems, and more — through the Apache OpenDAL abstraction layer. It exposes two core MCP tools (read and list) and uses a convention-based environment variable scheme to configure any number of named storage services without code changes. Data engineers and developers use it so that Claude can directly browse and read files stored in cloud object stores during analysis or migration tasks.
Prerequisites
- Python 3.8 or higher
- uv installed (https://docs.astral.sh/uv/getting-started/installation/) for running with uvx
- Credentials for the storage services you want to access (e.g. AWS access keys for S3)
- An MCP-compatible client such as Claude Desktop
Install mcp-server-opendal from PyPI
Install the package with pip. The uvx command used in the Claude Desktop config can run it directly without a global install if you have uv available.
pip install mcp-server-opendalConfigure storage service environment variables
Each storage backend uses the naming pattern OPENDAL_<ALIAS>_<KEY>=<VALUE>. Choose a short alias for each service. The TYPE key determines the backend driver (s3, azblob, gcs, fs, etc.).
# Example: S3-compatible service aliased as "mys3"
export OPENDAL_MYS3_TYPE=s3
export OPENDAL_MYS3_BUCKET=mybucket
export OPENDAL_MYS3_REGION=us-east-1
export OPENDAL_MYS3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export OPENDAL_MYS3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEYAdd the server to your Claude Desktop configuration
Edit your Claude Desktop config file and add the opendal server entry. Pass your storage env vars in the env block. You can also use a .env file in the working directory — the server loads it automatically.
{
"mcpServers": {
"opendal": {
"command": "uvx",
"args": ["mcp-server-opendal"],
"env": {
"OPENDAL_MYS3_TYPE": "s3",
"OPENDAL_MYS3_BUCKET": "mybucket",
"OPENDAL_MYS3_REGION": "us-east-1",
"OPENDAL_MYS3_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
"OPENDAL_MYS3_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY"
}
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop. The opendal MCP tools (list and read) will be available, referencing configured storage aliases via URI-style paths such as mys3://path/to/file.
Verify connectivity with the MCP inspector
Use the MCP inspector tool to confirm the server starts correctly and lists the configured tools before connecting your desktop client.
npx @modelcontextprotocol/inspector \
uv run mcp-server-opendalApache OpenDAL MCP Examples
Client configuration
Claude Desktop configuration with an S3 bucket aliased as mys3. Add additional OPENDAL_<ALIAS>_* keys for each additional service.
{
"mcpServers": {
"opendal": {
"command": "uvx",
"args": ["mcp-server-opendal"],
"env": {
"OPENDAL_MYS3_TYPE": "s3",
"OPENDAL_MYS3_BUCKET": "mybucket",
"OPENDAL_MYS3_REGION": "us-east-1",
"OPENDAL_MYS3_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
"OPENDAL_MYS3_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY"
}
}
}
}Prompts to try
Example prompts that use the list and read tools to browse and retrieve content from configured storage backends.
- "List all files in the root of mys3://"
- "List the contents of mys3://data/reports/2025/"
- "Read the file mys3://configs/app.json and summarise its contents"
- "Find all CSV files under mys3://datasets/ and tell me their sizes"
- "Read mys3://logs/error.log and identify any recurring error patterns"Troubleshooting Apache OpenDAL MCP
Storage service not found when using a path alias
Make sure the environment variable prefix exactly matches the alias in your path (e.g. OPENDAL_MYS3_TYPE for the mys3:// alias). Variable names are case-insensitive on most systems but the alias portion must match. Restart the MCP server after changing env vars.
Access denied errors when reading from S3
Verify that the IAM user or role associated with your ACCESS_KEY_ID has s3:GetObject and s3:ListBucket permissions on the configured bucket. Also confirm the REGION and BUCKET values are correct.
uvx command not found
Install uv first: `pip install uv` or follow the official guide at https://docs.astral.sh/uv/getting-started/installation/. Alternatively change the command in the config to `python -m mcp_server_opendal` after installing with pip.
Frequently Asked Questions about Apache OpenDAL MCP
What is Apache OpenDAL MCP?
Apache OpenDAL MCP is a Model Context Protocol (MCP) server that model context protocol server that provides seamless access to multiple storage services including s3, azure blob storage, and google cloud storage through apache opendal™. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Apache OpenDAL MCP?
Follow the installation instructions on the Apache OpenDAL MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Apache OpenDAL MCP?
Apache OpenDAL MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Apache OpenDAL MCP free to use?
Yes, Apache OpenDAL MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Apache OpenDAL MCP Alternatives — Similar Cloud Services Servers
Looking for alternatives to Apache OpenDAL MCP? 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 Apache OpenDAL MCP 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 Apache OpenDAL MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.