# Xuanwo/mcp-server-opendal [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/Xuanwo/mcp-server-opendal  
**GitHub Stars:** 35  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/xuanwo-mcp-server-opendal

## Description
Model Context Protocol Server for Apache OpenDAL™

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-server-opendal": {
    "command": "uvx",
    "args": ["mcp-server-opendal"]
  }
}
```

## Documentation

## 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:

```shell
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:

```text
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.

_Full upstream README: https://allmcps.com/mcp/xuanwo-mcp-server-opendal/readme_