Model Context Protocol Server for Apache OpenDAL™

一个通过 Apache OpenDAL™ 提供对多种存储服务访问的 Model Context Protocol (MCP) 服务器实现。

功能

• 无缝访问包括 S3、Azure Blob 存储、Google Cloud 存储等多种存储服务
• 列出存储服务中的文件和目录
• 自动检测文本/二进制内容并读取文件
• 基于环境变量的配置

安装

pip install mcp-server-opendal

使用与 Claude Desktop

在 claude_desktop_config.json 中添加以下内容：

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

需要在您的机器上安装 uv。请参阅 官方文档 获取安装指南。

环境变量

通过设置环境变量来配置存储服务。每个服务都需要一个前缀和特定的配置选项。

例如，要配置一个别名为 "mys3" 的 S3 服务：

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

然后您可以使用如 read 和 list 工具与 mys3://path/to/file 进行交互。

mcp-server-opendal 同时也会从 .env 文件中加载配置。

开发

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