MCP Server Opendal

🚀 Apache OpenDAL™ Model Context Protocol Server

An implementation of the Model Context Protocol (MCP) server that provides access to multiple storage services, powered by Apache OpenDAL™.

🚀 Quick Start

This is an implementation of the Model Context Protocol (MCP) server. It leverages Apache OpenDAL™ to offer seamless access to various storage services.

✨ Features

• Seamlessly access multiple storage services, including S3, Azure Blob Storage, Google Cloud Storage, etc.
• List files and directories in the storage services.
• Automatically detect text/binary formats to read file contents.
• Configuration based on environment variables.

📦 Installation

pip install mcp-server-opendal

💻 Usage Examples

Basic Usage

Using Claude Desktop

Add the following content to claude_desktop_config.json:

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

The uv tool needs to be installed on the machine. Check the official documentation for installation instructions.

Advanced Usage

Environment Variable Configuration

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

For example, to configure an S3 service with the 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 the read and list commands with mys3://path/to/file.

mcp-server-opendal also loads configurations from the .env file.

Development

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