mcpField
M
Model Context Protocol Server for Apache OpenDAL™

Model Context Protocol Server for Apache OpenDAL™

本地服务
github.com/Xuanwo文件与存储3581 周前更新

关于 Model Context Protocol Server for Apache OpenDAL™

Apache OpenDAL™ 的 MCP 服务,可通过统一接口访问 S3、Azure Blob Storage、Google Cloud Storage 等多种存储服务。它适合希望让 MCP 客户端读取云端或对象存储文件的用户。

主要功能

  1. 01访问多种存储服务
  2. 02列出存储中的文件与目录
  3. 03读取文件内容并自动识别文本或二进制
  4. 04通过环境变量配置存储服务

适用场景

  1. 01让 Claude Desktop 浏览 S3 等对象存储中的文件
  2. 02读取云存储中的文本或二进制文件
  3. 03在多个存储服务之间切换访问

MCP 相关

该服务以 MCP 服务的形式暴露 list 与 read 等工具,MCP 客户端可通过 mys3:// 之类的路径访问已配置的存储服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"opendal": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector"
]
}
}
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Apache OpenDAL™ 的 Model Context Protocol 服务

一个 Model Context Protocol(MCP)服务实现,可通过 Apache OpenDAL™ 访问各种存储服务。

PyPI - Version PyPI - Python Version Lint and Test

功能

  • 无缝访问多种存储服务,包括 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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。