MCP Server Opendal

🚀 Apache OpenDAL™ 模型上下文協議服務器

Apache OpenDAL™ 模型上下文協議服務器是一個基於 Apache OpenDAL™ 實現的 Model Context Protocol (MCP) 服務器，它提供了對多種存儲服務的便捷訪問，為用戶在不同存儲服務間的數據操作提供了高效解決方案。

✨ 主要特性

• 多服務訪問：可無縫訪問多種存儲服務，如 S3、Azure Blob 存儲、Google Cloud Storage 等。
• 文件管理：支持列出存儲服務中的文件和目錄，方便用戶管理數據。
• 智能讀取：自動檢測文本/二進制格式以讀取文件內容，提升使用體驗。
• 靈活配置：基於環境變量進行配置，方便快捷。

📦 安裝指南

pip install mcp-server-opendal

💻 使用示例

基礎用法

在 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