Loading...
ADLS2 MCP server provides a standardized interface for interacting with Azure Data Lake Storage Gen2, enabling file operations through MCP tools.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
ADLS2 MCP server provides a standardized interface for interacting with Azure Data Lake Storage Gen2, enabling file operations through MCP tools.
The ADLS2 MCP server can be safe if operated in read-only mode with properly configured Azure ADLS2 permissions. Risks arise when write operations are enabled, especially if the storage account key is exposed or permissions are overly permissive. Careful configuration and monitoring are essential.
Performance is largely dependent on the network connection and the performance of the Azure Data Lake Storage Gen2 service. Large file uploads and downloads may be subject to throttling.
Cost is primarily determined by the amount of data stored in ADLS2 and the number of API calls made. Consider optimizing data storage and access patterns to minimize costs.
pip install -e ".[dev]"{
"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"
}
}
}
}AZURE_STORAGE_ACCOUNT_KEYlist_filesystemsLists all filesystems in the Azure Data Lake Storage Gen2 account.
Read-only operation that does not modify any data.
create_filesystemCreates a new filesystem (container) in the ADLS2 storage account.
Creates a new filesystem, which can impact storage organization.
delete_filesystemDeletes an existing filesystem from the ADLS2 storage account.
Deletes an entire filesystem and all its contents.
upload_fileUploads a file to a specified path in the ADLS2 storage account.
Writes data to the storage account, potentially overwriting existing files.
download_fileDownloads a file from the ADLS2 storage account to a local path.
Read-only operation that retrieves data from the storage account.
file_existsChecks if a file exists at a given path in the ADLS2 storage account.
Read-only operation that does not modify any data.
rename_fileRenames or moves a file within the ADLS2 storage account.
Modifies the file structure and can potentially lead to data loss if not handled carefully.
get_file_propertiesRetrieves properties of a file in the ADLS2 storage account.
Read-only operation that does not modify any data.
get_file_metadataRetrieves metadata associated with a file in the ADLS2 storage account.
Read-only operation that does not modify any data.
set_file_metadataSets metadata for a file in the ADLS2 storage account.
Modifies file metadata, which can affect data management and organization.
set_file_metadata_jsonSets multiple metadata key-value pairs for a file using JSON format.
Modifies file metadata, which can affect data management and organization.
create_directoryCreates a new directory in the ADLS2 storage account.
Creates a new directory, which can impact storage organization.
delete_directoryDeletes a directory from the ADLS2 storage account.
Deletes a directory and all its contents.
rename_directoryRenames or moves a directory within the ADLS2 storage account.
Modifies the directory structure and can potentially lead to data loss if not handled carefully.
directory_existsChecks if a directory exists at a given path in the ADLS2 storage account.
Read-only operation that does not modify any data.
directory_get_pathsGets all paths under the specified directory in the ADLS2 storage account.
Read-only operation that does not modify any data.
Environment Variable
The ADLS2 MCP server can be safe if operated in read-only mode with properly configured Azure ADLS2 permissions. Risks arise when write operations are enabled, especially if the storage account key is exposed or permissions are overly permissive. Careful configuration and monitoring are essential.
Autonomy depends on the configured permissions and the setting of READ_ONLY_MODE. Without proper configuration, destructive operations are possible.
Production Tip
Ensure that the principle running the server has the least privilege necessary to perform the required operations on the ADLS2 storage account.
The server supports authentication using either an Azure Storage Account Key or Azure CLI credentials.
Set the READ_ONLY_MODE environment variable to 'true'.
The server will attempt to authenticate using Azure CLI credentials. Ensure you have logged in with Azure CLI before running the server.
By default, files are uploaded to the './uploads' directory and downloaded to the './downloads' directory. These can be configured using the UPLOAD_ROOT and DOWNLOAD_ROOT environment variables.
Clone the repository, create a virtual environment, install dependencies, configure environment variables, and update the Claude Desktop configuration.
Yes, this server is designed to be compatible with any tool that supports the Model Context Protocol.
Python 3.13 or higher is required.