mcp-server-opendal

mcp-server-opendal

Model Context Protocol server for accessing diverse storage services via Apache OpenDAL.

33
Stars
7
Forks
33
Watchers
2
Issues
mcp-server-opendal is an implementation of the Model Context Protocol (MCP) that offers seamless access to a variety of storage services through Apache OpenDAL. It enables listing and reading files from services like S3, Azure Blob Storage, and Google Cloud Storage, while supporting environment variable-based configuration. The tool integrates with platforms such as Claude Desktop and can be easily configured using environment variables or a .env file.

Key Features

Seamless access to multiple storage services (S3, Azure Blob Storage, Google Cloud Storage, and more)
File and directory listing capabilities
Automatic detection of text or binary content when reading files
Integration with Apache OpenDAL for unified storage interface
Configurable via environment variables and .env file
Supports use from platforms like Claude Desktop
Command line interface for file operations
Easy installation via pip
Extensible to additional storage backends
Support for running through uv for parallel or managed process execution

Use Cases

Providing AI models with seamless access to cloud and object storage data
Listing and exploring files in multi-cloud environments
Reading file content from various storage services for downstream processing
Integrating storage access into AI and data analysis desktop tools like Claude Desktop
Configuring and switching between multiple storage backends via environment variables
Building context-aware applications that require on-demand access to files across different services
Automating data movement between storage providers
Performing development and testing of applications needing cloud storage abstraction
Facilitating secure and dynamic connections to storage by managing credentials through environment variables
Supporting collaborative workflows where different teams or systems need standardized storage access

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™.

PyPI - Version PyPI - Python Version Lint and Test

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

shell
pip install mcp-server-opendal

Usage with Claude Desktop

Add the following to claude_desktop_config.json:

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

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

Star History

Star History Chart

Repository Owner

Xuanwo
Xuanwo

User

Repository Details

Language Python
Default Branch main
Size 109 KB
Contributors 3
License Apache License 2.0
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • MCP OpenAI Server

    MCP OpenAI Server

    Seamlessly connect OpenAI's models to Claude via Model Context Protocol.

    MCP OpenAI Server acts as a Model Context Protocol (MCP) bridge allowing Claude Desktop to access and interact with multiple OpenAI chat models. It enables users to leverage models such as GPT-4o and O1 directly from Claude using a straightforward message-passing interface. The server supports easy integration through configuration and provides basic error handling. Designed for use with Node.js and requiring an OpenAI API key, it is tailored for macOS with support for other platforms in progress.

    • 69
    • MCP
    • mzxrai/mcp-openai
  • Codex MCP Server

    Codex MCP Server

    An MCP-compatible server delivering enriched blockchain data for AI models.

    Codex MCP Server implements the Model Context Protocol to provide enriched blockchain data from Codex. It is compatible with MCP clients such as Claude Desktop and Claude CLI, allowing seamless integration in AI workflows that require blockchain context. Users can run the server locally or via npx, and configure it for various MCP-compatible tools using their Codex API key.

    • 20
    • MCP
    • Codex-Data/codex-mcp
  • Google Workspace MCP Server

    Google Workspace MCP Server

    A secure MCP server bridging Google Workspace and AI clients.

    Google Workspace MCP Server implements the Model Context Protocol to enable secure integration between Google Workspace services—such as Gmail, Calendar, and Drive—and any MCP-compatible AI client. It allows users to read, search, create, update, and delete Google Calendar events, emails, and Drive files directly through an AI agent interface. The tool ensures authentication via Google OAuth and provides a seamless setup process for both server and client sides. This makes it easier for AI-powered workflows to interact with Google Workspace data securely and contextually.

    • 20
    • MCP
    • giuseppe-coco/Google-Workspace-MCP-Server
  • Daisys MCP server

    Daisys MCP server

    A beta server implementation for the Model Context Protocol supporting audio context with Daisys integration.

    Daisys MCP server provides a beta implementation of the Model Context Protocol (MCP), enabling seamless integration between the Daisys AI platform and various MCP clients. It allows users to connect MCP-compatible clients to Daisys by configurable authentication and environment settings, with out-of-the-box support for audio file storage and playback. The server is designed to be extensible, including support for both user-level deployments and developer contributions, with best practices for secure authentication and dependency management.

    • 10
    • MCP
    • daisys-ai/daisys-mcp
  • MCP ChatGPT Server

    MCP ChatGPT Server

    Enables direct access to OpenAI's ChatGPT API from Claude Desktop via the Model Context Protocol.

    MCP ChatGPT Server runs as an MCP-compliant server, allowing users to access OpenAI's ChatGPT API seamlessly within Claude Desktop. It supports customizable model parameters, automated conversation state management, integrated web search for up-to-date information, and facilitates interactive discussions between Claude and ChatGPT. Users can configure model selection, temperature, token limits, and use their own OpenAI API keys.

    • 14
    • MCP
    • billster45/mcp-chatgpt-responses
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results