Skip to main content

A Model Context Protocol server providing tools to access storage services for usage by LLMs

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_xuanwo_mcp_server_opendal-0.1.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_xuanwo_mcp_server_opendal-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_xuanwo_mcp_server_opendal-0.1.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_xuanwo_mcp_server_opendal-0.1.0.tar.gz
Algorithm Hash digest
SHA256 8beed046d4979521b2baaac5ae67f137c4f5e4300d735c88616facd47e4b33bb
MD5 2d11578600f044d40be2771503718d9a
BLAKE2b-256 38319b3da70b43bbbe478b6e67bf8f240eae1d6089fd28a9b335949acbae6bcb

See more details on using hashes here.

File details

Details for the file iflow_mcp_xuanwo_mcp_server_opendal-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_xuanwo_mcp_server_opendal-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_xuanwo_mcp_server_opendal-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c155a9c1851f85dd28a2aec6015b178bd3e281d529a8aa1d00c6efe473124163
MD5 bb4ea0fab0720a784f6bcdbae7dc93a2
BLAKE2b-256 3af834a634b0cdee68acfd7432d00fb9ee3d96c3b98ec977b202db2ce27769c4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page