MCP Server Opendal

🚀 Apache OpenDAL™ モデルコンテキストプロトコルサーバ

Apache OpenDAL™ を通じて、複数のストレージサービスへのアクセスを提供する Model Context Protocol (MCP) サーバの実装です。

🚀 クイックスタート

このサーバは、Apache OpenDAL™ を利用して、複数のストレージサービスにアクセスできる Model Context Protocol (MCP) サーバの実装です。以下の手順で簡単に始めることができます。

✨ 主な機能

• S3、Azure Blob ストレージ、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