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

这是一个实现了模型上下文协议（Model Context Protocol，简称 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