erikhoward/adls-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:
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.
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:
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:
2 - Create and activate virtual environment:
Linux/macOS:
Windows:
3 - Install dependencies:
4 - Copy and configure environment variables:
Edit .env with your settings.
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: