Back to Catalog

mcp-server-opendal

Xuanwo/mcp-server-opendal
🔗 Latest commit:f49ee92
🕒 Updated:Sep 9, 2025, 01:06 PM
Python
Cloud

Model Context Protocol Server for Apache OpenDAL™

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score63/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:33
👥 Contributors:3
📋 Total Issues:4
📦 Has Releases:Yes
🔧 Has CI/CD Pipeline:Yes
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "mcp-server-opendal-with-config": {
    "command": "uvx",
    "args": [
      "mcp-server-opendal"
    ],
    "env": {
      "YOUR_ENV_VAR": "YOUR_ENV_VALUE"
    }
  },
  "mcp-server-opendal-uv-run": {
    "command": "uv",
    "args": [
      "run",
      "mcp-server-opendal"
    ],
    "env": {}
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:
Prompts:
Resources:
Sampling:
Roots:
Logging:
STDIO Transport:
HTTP Transport:
OAuth2 Auth:
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Xuanwo/mcp-server-opendal)](https://archestra.ai/mcp-catalog/xuanwo__mcp-server-opendal)
README.md

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

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
mcp-server-opendal MCP Server | Documentation & Integration | Archestra