ADLS2 MCP Server 🚀

ADLS2 MCP サーバー 🚀

Azure Data Lake Storage Gen2 向けの Model Context Protocol（MCP）サーバー実装です。このサービスは ADLS2 ストレージとやり取りするための標準インターフェースを提供し、MCP ツールを通じてファイル操作を可能にします。

セットアップ 🛠️

インストール 📦

Python 3.13 以降が必要です。

uv を使用してパッケージをインストールします：

uv pip install adls2-mcp-server

MCP の設定 ⚙️

Claude Desktop の設定

1 - Claude Desktop の設定を編集します：

claude_desktop_config.json を開き、次の設定を追加します。

MacOs では、ファイルは次の場所にあります： ~/Library/Application Support/Claude Desktop/claude_desktop_config.json。

Windows では、ファイルは次の場所にあります： %APPDATA%\Claude Desktop\claude_desktop_config.json。

{
    "mcpServers": {
        "adls2": {
            "command": "adls2-mcp-server",
            "env": {
                "LOG_LEVEL": "DEBUG",
                "UPLOAD_ROOT": "/path/to/store/uploads",
                "DOWNLOAD_ROOT": "/path/to/store/downloads",
                "AZURE_STORAGE_ACCOUNT_NAME": "your-azure-adls2-storage-account-name",
                "READ_ONLY_MODE": "false"
            }
        }
    }
}

使用できる環境設定変数は次のとおりです：

変数	説明	デフォルト
LOG_LEVEL	ログレベル	INFO
UPLOAD_ROOT	ファイルアップロード用のルートディレクトリ	./uploads
DOWNLOAD_ROOT	ファイルダウンロード用のルートディレクトリ	./downloads
AZURE_STORAGE_ACCOUNT_NAME	Azure ADLS2 ストレージアカウント名	None
AZURE_STORAGE_ACCOUNT_KEY	Azure ADLS2 ストレージアカウントキー（任意）	None
READ_ONLY_MODE	サーバーを読み取り専用モードで動作させるかどうか	true

AZURE_STORAGE_ACCOUNT_KEY が設定されていない場合、サーバーは Azure CLI の認証情報を使用して認証を試みます。サーバーを実行する前に、Azure CLI にログインしていることを確認してください：

az login

2 - Claude Desktop を再起動します。

使用可能なツール 🔧

ファイルシステム（コンテナー）操作

• list_filesystems - ストレージアカウント内のすべてのファイルシステムを一覧表示します
• create_filesystem - 新しいファイルシステムを作成します
• delete_filesystem - 既存のファイルシステムを削除します

ファイル操作

• upload_file - ファイルを ADLS2 にアップロードします
• download_file - ADLS2 からファイルをダウンロードします
• file_exists - ファイルが存在するか確認します
• rename_file - ファイルの名前を変更／移動します
• get_file_properties - ファイルのプロパティを取得します
• get_file_metadata - ファイルのメタデータを取得します
• set_file_metadata - ファイルのメタデータを設定します
• set_file_metadata_json - JSON を使用して複数のメタデータのキーと値のペアを設定します

ディレクトリ操作

• create_directory - 新しいディレクトリを作成します
• delete_directory - ディレクトリを削除します
• rename_directory - ディレクトリの名前を変更／移動します
• directory_exists - ディレクトリが存在するか確認します
• directory_get_paths - 指定したディレクトリ以下のすべてのパスを取得します

開発 💻

ローカル開発環境のセットアップ

1 - リポジトリをクローンします：

git clone https://github.com/erikhoward/adls2-mcp-server.git
cd adls2-mcp-server

2 - 仮想環境を作成して有効化します：

Linux/macOS：

python -m venv .venv
source .venv/bin/activate

Windows：

.venv\Scripts\activate

3 - 依存関係をインストールします：

pip install -e ".[dev]"

4 - 環境変数をコピーして設定します：

cp .env.example .env

.env を開き、設定を編集します。

AZURE_STORAGE_ACCOUNT_NAME=your_azure_adls2_storage_account_name
AZURE_STORAGE_ACCOUNT_KEY=your_azure_adls2_storage_key (optional)
DOWNLOAD_ROOT=/path/to/download/folder
UPLOAD_ROOT=/path/to/upload/folder
READ_ONLY_MODE=True
LOG_LEVEL=INFO

AZURE_STORAGE_ACCOUNT_KEY が設定されていない場合、サーバーは Azure CLI の認証情報を使用して認証を試みます。サーバーを実行する前に、Azure CLI にログインしていることを確認してください：

az login

5 - Claude Desktop の設定

claude_desktop_config.json を開き、次の設定を追加します。

MacOs では、ファイルは次の場所にあります： ~/Library/Application Support/Claude Desktop/claude_desktop_config.json。

Windows では、ファイルは次の場所にあります： %APPDATA%\Claude Desktop\claude_desktop_config.json。

{
    "mcpServers": {
        "adls2": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/adls2-mcp-server/repo",
                "run",
                "adls2-mcp-server"
            ],
            "env": {
                "LOG_LEVEL": "DEBUG",
                "UPLOAD_ROOT": "/path/to/store/uploads",
                "DOWNLOAD_ROOT": "/path/to/store/downloads",
                "AZURE_STORAGE_ACCOUNT_NAME": "your-azure-adls2-storage-account-name",
                "READ_ONLY_MODE": "false"
            }
        }
    }
}

6 - Claude Desktop を再起動します。

コントリビューション 🤝

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m '✨ Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. プルリクエストを作成します

ライセンス ⚖️

MIT ライセンスのもとで提供されています。詳細は LICENSE.md ファイルをご覧ください。

これは Microsoft の公式製品ではありません。