adls-mcp-server

🚀 Azure 数据湖存储 Gen2 MCP 服务器

这是一个用于 Azure 数据湖存储 Gen2 的模型上下文协议 (MCP) 服务实现。该服务为与 ADLS2 存储进行交互提供了标准化接口，可借助 MCP 工具实现文件操作。

🚀 快速开始

本项目是一个用于 Azure 数据湖存储 Gen2 的 MCP 服务实现，为 ADLS2 存储交互提供标准化接口。以下将详细介绍其安装、配置、开发和贡献等方面的内容。

✨ 主要特性

• 为 Azure 数据湖存储 Gen2 提供标准化的 MCP 服务接口。
• 支持通过 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": "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"
            }
        }
    }
}

🛠️ 开发指南

1. 克隆仓库：使用 Git 克隆项目仓库。

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

2. 创建功能分支：

git checkout -b feature/AmazingFeature

3. 提交更改：

git add .
git commit -m '✨ 添加一些 Amazing 功能'

4. 推送到远程仓库：

git push origin feature/AmazingFeature

5. 创建 Pull Request：在 GitHub 上为你的功能分支提交 Pull Request。

🤝 贡献指南

欢迎贡献！请随意提交 Pull Request。

1. fork 仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m '✨ 添加一些 Amazing 功能')
4. 推送到远程分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目 licensed under MIT License - 请查看 LICENSE.md 文件。

⚠️ 重要提示

这不是微软官方产品。