MCP Server Opendal

What Xuanwo/mcp-server-opendal MCP server does

Xuanwo/mcp-server-opendal MCP server connects MCP clients to storage services supported by Apache OpenDAL. The project is suited to the 📂 File Systems category because it exposes file and directory operations rather than a provider-specific API. The README identifies S3, Azure Blob Storage, and Google Cloud Storage as examples of supported services, while OpenDAL provides the broader storage-service abstraction.

Agents can use the server to inspect paths and retrieve file contents. Storage locations are referenced with an alias-based URL such as mys3://path/to/file, where mys3 corresponds to a configured service.

How it works

The server discovers storage configurations from environment variables. Each configured service uses an OPENDAL_ prefix, an alias, and service-specific settings. For example, an S3 configuration can define its type, bucket, region, endpoint, access key ID, and secret access key under the OPENDAL_MYS3_ prefix.

After configuration, MCP clients can invoke the server's list and read tools. list provides files and directories from a storage service. read retrieves file contents and detects whether the result should be treated as text or binary data. Xuanwo/mcp-server-opendal MCP server also loads values from a .env file.

Setup and configuration

Install the package from PyPI with:

pip install mcp-server-opendal

The documented Claude Desktop setup runs the package through uvx and passes environment values in the client's MCP configuration. This requires uv to be installed separately.

A typical S3 configuration follows this pattern:

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

Replace the alias and values for the target service. The same environment-based approach applies to other OpenDAL-supported services, using the configuration options those services require.

Tools and capabilities

Xuanwo/mcp-server-opendal MCP server provides:

• list for browsing files and directories.
• read for retrieving file contents.
• Automatic text/binary detection when reading files.
• Access to multiple storage services through Apache OpenDAL.
• Alias-based paths such as mys3://path/to/file.

Limitations and notes

It also does not describe write, delete, move, or metadata operations; the documented tools are list and read. Credentials and endpoints must be supplied through the environment or .env configuration, and the example includes access keys that should be replaced with appropriate values.

It does not describe additional client-specific setup requirements.