Opendal MCP Server

It requires `uv` to be installed on your machine. Check the [official documentation](https://docs.astral.sh/uv/getting-started/installation/) for

Local serverstdio

What is the Opendal MCP server?

Opendal becomes available to MCP clients through the opendal mcp server. It requires uv to be installed on your machine. Check the official documentation for installation guides.

What Opendal does

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

Key capabilities

  • 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

Installing the opendal mcp server

The server is distributed via npm as @modelcontextprotocol/inspector, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply 4 environment variables: YOUR_ENV_VAR, OPENDAL_MYS3_REGION, OPENDAL_MYS3_ACCESS_KEY_ID, OPENDAL_MYS3_SECRET_ACCESS_KEY. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

File and storage servers are what separate an assistant that talks about your documents from one that actually works with them. Opendal sits in that group. Worth comparing against the other file systems servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by Xuanwo.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the opendal mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Opendal MCP server

{
  "mcpServers": {
    "server-opendal": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"],
      "env": {
        "YOUR_ENV_VAR": "your-value",
        "OPENDAL_MYS3_REGION": "your-value",
        "OPENDAL_MYS3_ACCESS_KEY_ID": "your-value",
        "OPENDAL_MYS3_SECRET_ACCESS_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
YOUR_ENV_VARConfiguration value read at startup.Optional
OPENDAL_MYS3_REGIONConfiguration value read at startup.Optional
OPENDAL_MYS3_ACCESS_KEY_IDCredential the server authenticates with.Yes
OPENDAL_MYS3_SECRET_ACCESS_KEYCredential the server authenticates with.Yes

Frequently asked questions

It connects Opendal to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Opendal directly.