Opendal

🚀 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