What is Adls Mcp Server

adls-mcp-server is an implementation of a Model Context Protocol (MCP) server specifically designed for Microsoft Azure Data Lake Storage Gen2. It provides a standardized interface for performing file operations within ADLS2 storage using MCP tools.

Use cases

Use cases for adls-mcp-server include managing large datasets in Azure, facilitating data uploads and downloads through a standardized interface, and integrating with other MCP-compliant tools for enhanced data workflows.

How to use

To use adls-mcp-server, first install it using the command uv pip install adls2-mcp-server. Then configure the MCP settings in the ‘claude_desktop_config.json’ file, specifying parameters such as upload and download directories, Azure storage account name, and logging level.

Key features

Key features of adls-mcp-server include compatibility with MCP, support for file operations in Azure Data Lake Storage Gen2, customizable logging levels, and the ability to set upload and download root directories.

Where to use

adls-mcp-server is primarily used in data engineering, big data analytics, and cloud storage management, particularly in environments that leverage Azure Data Lake Storage for data processing and storage.

ADLS2 MCP Server 🚀

A Model Context Protocol (MCP) server implementation for Azure Data Lake Storage Gen2. This service provides a standardized interface for interacting with ADLS2 storage, enabling file operations through MCP tools.

Setup 🛠️

Installation 📦

Requires Python 3.13 or higher.

Install the package using uv:

uv pip install adls2-mcp-server

MCP Configuration ⚙️

Claude Desktop Configuration

1 - Edit Claude Desktop Configuration:

Open claude_desktop_config.json and add the following configuration.

On MacOs, the file is located here:
~/Library/Application Support/Claude Desktop/claude_desktop_config.json.

On Windows, the file is located here:
%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"
      }
    }
  }
}

The following is a table of available environment configuration variables:

Variable	Description	Default
LOG_LEVEL	Logging level	INFO
UPLOAD_ROOT	Root directory for file uploads	./uploads
DOWNLOAD_ROOT	Root directory for file downloads	./downloads
AZURE_STORAGE_ACCOUNT_NAME	Azure ADLS2 storage account name	None
AZURE_STORAGE_ACCOUNT_KEY	Azure ADLS2 storage account key (optional)	None
READ_ONLY_MODE	Whether the server should operate in read-only mode	true

If AZURE_STORAGE_ACCOUNT_KEY is not set, the server will attempt to authenticate using Azure CLI credentials. Ensure you have logged in with Azure CLI before running the server:

az login

2 - Restart Claude Desktop.

Available Tools 🔧

Filesystem (container) Operations

• list_filesystems - List all filesystems in the storage account
• create_filesystem - Create a new filesystem
• delete_filesystem - Delete an existing filesystem

File Operations

• upload_file - Upload a file to ADLS2
• download_file - Download a file from ADLS2
• file_exists - Check if a file exists
• rename_file - Rename/move a file
• get_file_properties - Get file properties
• get_file_metadata - Get file metadata
• set_file_metadata - Set file metadata
• set_file_metadata_json - Set multiple metadata key-value pairs using JSON

Directory Operations

• create_directory - Create a new directory
• delete_directory - Delete a directory
• rename_directory - Rename/move a directory
• directory_exists - Check if a directory exists
• directory_get_paths - Get all paths under the specified directory

Development 💻

Local Development Setup

1 - Clone the repository:

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

2 - Create and activate virtual environment:

Linux/macOS:

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

Windows:

.venv\Scripts\activate

3 - Install dependencies:

pip install -e ".[dev]"

4 - Copy and configure environment variables:

cp .env.example .env

Edit .env with your settings.

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

If AZURE_STORAGE_ACCOUNT_KEY is not set, the server will attempt to authenticate using Azure CLI credentials. Ensure you have logged in with Azure CLI before running the server:

az login

5 - Claude Desktop Configuration

Open claude_desktop_config.json and add the following configuration.

On MacOs, the file is located here:
~/Library/Application Support/Claude Desktop/claude_desktop_config.json.

On Windows, the file is located here:
%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 - Restart Claude Desktop.

Contributions 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m '✨ Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License ⚖️

Licensed under MIT - see LICENSE.md file.

This is not an official Microsoft product.