How to add Apache OpenDAL MCP Server to Cursor

Access S3, Azure Blob, Google Cloud Storage and many more storage services through one unified MCP interface. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 34★ · stdio · apikey

Cursor config for Apache OpenDAL MCP Server

pip install mcp-server-opendal

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

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Apache OpenDAL MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Apache OpenDAL MCP Server's tools to confirm it's connected.

Before you start

uv installed (the config runs the server with uvx)
Python (mcp-server-opendal is a Python/PyPI package)
Credentials and configuration for each storage service, supplied as OPENDAL_<ALIAS>_* environment variables (or via a .env file)

What Apache OpenDAL MCP Server can do in Cursor

list

List files and directories from a configured storage service, addressed via an alias URI such as mys3://path/to/dir.

read

Read the contents of a file from a configured storage service (e.g. mys3://path/to/file), with automatic text/binary detection.

Security

Storage credentials (e.g. S3 access key ID and secret access key) are supplied through environment variables prefixed per service alias, or loaded from a local .env file. Treat these credentials as secrets and scope them to only the buckets/containers the assistant needs.

Apache OpenDAL MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Apache OpenDAL MCP Server config there under the "mcpServers" key and restart the client.

Is Apache OpenDAL MCP Server safe to use with Cursor?

Which storage services are supported?

Any backend supported by Apache OpenDAL, including S3, Azure Blob Storage, Google Cloud Storage, and more. Each service is configured with a type and its specific options via environment variables.

How do I configure a storage service?

Set environment variables with a per-service alias prefix. For example, an S3 service aliased 'mys3' uses OPENDAL_MYS3_TYPE=s3, OPENDAL_MYS3_BUCKET=..., OPENDAL_MYS3_REGION=..., OPENDAL_MYS3_ACCESS_KEY_ID=..., and OPENDAL_MYS3_SECRET_ACCESS_KEY=.... You then reference files with mys3://path/to/file. Variables can also be loaded from a .env file.

What can the server do with my files?

It currently provides read-only access: listing directories and reading file contents. The README does not document write or delete operations.

View repo Full Apache OpenDAL MCP Server page