Apache OpenDAL™ 模型上下文协议服务器

一个实现模型上下文协议 (MCP) 的服务器，通过 Apache OpenDAL™ 提供对多种存储服务的访问。

功能

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

安装

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