Skip to main content
Glama
MCP Server for Apache OpenDAL™

MCP Server for Apache OpenDAL™

by Xuanwo

Model Context Protocol Server for Apache OpenDAL™

A Model Context Protocol (MCP) server implementation that provides access to various storage services via Apache OpenDAL™.

PyPI - Version PyPI - Python Version Lint and Test

Features

  • 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

Related MCP server: Alibaba Cloud DMS MCP Server

Installation

pip install mcp-server-opendal

Usage with Claude Desktop

Add the following to claude_desktop_config.json:

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

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

Environment variables

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

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

mcp-server-opendal will also load from .env.

Development

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

Available Tools

3 tools
get_infoB
Get metadata of file in OpenDAL service

Args:
    uri: resource URI, e.g. mys3://path/to/file

Returns:
    File metadata information

Inputs: uri (required).

listB
List files in OpenDAL service

Args:
    uri: resource URI, e.g. mys3://path/to/dir

Returns:
    String containing directory content

Inputs: uri (required).

readB
Read file content from OpenDAL service

Args:
    uri: resource URI, e.g. mys3://path/to/file

Returns:
    File content or error information

Inputs: uri (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_info retrieves metadata, list lists directory contents, and read reads file content. There is no overlap between them.

    Naming Consistency4/5

    Tools follow a verb_noun pattern (get_info, list, read), but 'list' and 'read' lack a noun component, which is a minor inconsistency. Overall, the naming is predictable.

    Tool Count2/5

    With only 3 tools, the server covers only read operations, which is too few for a full-featured storage abstraction like OpenDAL. Many essential operations (create, delete, update) are missing.

    Completeness2/5

    The tool surface is severely incomplete for the stated purpose. It only provides read and listing capabilities, leaving out write, delete, and other management operations required for a storage server.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables large language models to upload files directly to Alibaba Cloud Object Storage Service (OSS), supporting multiple OSS configurations and specified upload directories.
      15 npm
      7
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that bridges MCP clients with local LLM services, enabling seamless integration with MCP-compatible applications through standard tools like chat completion, model listing, and health checks.
      -