https://github.com/Xuanwo/mcp-server-opendal
Model Context Protocol Server for Apache OpenDAL™
https://github.com/Xuanwo/mcp-server-opendal
Last synced: about 1 month ago
JSON representation
Model Context Protocol Server for Apache OpenDAL™
- Host: GitHub
- URL: https://github.com/Xuanwo/mcp-server-opendal
- Owner: Xuanwo
- License: apache-2.0
- Created: 2025-03-04T13:15:53.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-05T05:25:38.000Z (about 2 months ago)
- Last Synced: 2025-03-05T06:27:20.257Z (about 2 months ago)
- Language: Python
- Size: 24.4 KB
- Stars: 8
- Watchers: 1
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-list - Xuanwo/mcp-server-opendal - server-opendal?style=social)](https://github.com/Xuanwo/mcp-server-opendal): Accesses various storage services via Apache OpenDAL. (Uncategorized / Uncategorized)
- awesome-mcp-zh - Xuanwo/mcp-server-opendal
- awesome-mcp-servers - Xuanwo/mcp-server-opendal - Access any storage with Apache OpenDAL™ (Legend / 📂 <a name="file-systems"></a>File Systems)
- awesome-mcp-servers - Xuanwo/mcp-server-opendal - Access any storage with Apache OpenDAL™ (Legend / 📂 <a name="file-systems"></a>File Systems)
- awesome-mcp-servers - Xuanwo/mcp-server-opendal - Apache OpenDAL™ でどのストレージにもアクセスできます (サーバー実装 / 📂 <a name="file-systems"></a>ファイルシステム)
- awesome-mcp-servers - OpenDAL MCP Server - Model Context Protocol Server for Apache OpenDAL™ (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - OpenDAL MCP Server - Model Context Protocol Server for Apache OpenDAL™ (Table of Contents / Other Tools and Integrations)
README
# Model Context Protocol Server for Apache OpenDAL™
A Model Context Protocol (MCP) server implementation that provides access to various storage services via [Apache OpenDAL™](https://opendal.apache.org/).
## 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
```shell
pip install mcp-server-opendal
```
## Usage
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
```shell
npx @modelcontextprotocol/inspector \
uv run mcp-server-opendal
```