ADLS2 MCP Server 🚀

基本能力

产品定位

ADLS2 MCP Server 是一个为 Azure Data Lake Storage Gen2 实现的 MCP 服务器，提供标准化的文件操作接口。

核心功能

• 文件系统操作：列出、创建、删除文件系统。
• 文件操作：上传、下载、重命名、检查文件存在、获取文件属性和元数据、设置文件元数据。
• 目录操作：创建、删除、重命名目录，检查目录存在，获取目录下所有路径。

适用场景

• 需要与 Azure Data Lake Storage Gen2 进行交互的应用。
• 需要通过标准化接口管理文件存储的场景。

工具列表

• 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：获取指定目录下的所有路径。

常见问题解答

• 如何认证？ 如果没有设置 AZURE_STORAGE_ACCOUNT_KEY，服务器将尝试使用 Azure CLI 凭证进行认证。确保在运行服务器之前已通过 Azure CLI 登录。
• 如何配置？ 通过编辑 claude_desktop_config.json 文件并添加相应的 MCP 服务器配置。

使用教程

使用依赖

• Python 3.13 或更高版本。
• 通过 Azure CLI 登录： bash az login

安装教程

使用 uv 安装包：

uv pip install adls2-mcp-server

调试方式

1. 克隆仓库： bash git clone https://github.com/erikhoward/adls2-mcp-server.git cd adls2-mcp-server
2. 创建并激活虚拟环境：
3. Linux/macOS： bash python -m venv .venv source .venv/bin/activate
4. Windows： bash .venv\Scripts\activate
5. 安装依赖： bash uv pip install -e ".[dev]"
6. 配置环境变量： bash cp .env.example .env 编辑 .env 文件设置相关参数。
7. 配置 Claude Desktop： 编辑 claude_desktop_config.json 文件并添加 MCP 服务器配置。
8. 重启 Claude Desktop。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。