azure-adf-mcp

An MCP (Model Context Protocol) server that exposes Azure Data Factory operations as tools any LLM can call — trigger pipelines, monitor runs, inspect datasets, and get factory health summaries through natural language.

Demo

"Trigger the CopyRawToStaging pipeline and tell me when it's done."

Claude calls trigger_pipeline, gets back a run ID, polls get_run_status, and reports back — all without leaving the chat.

"can you give me list of all pipline runs in last 24 hours."

Related MCP server: Azure DevOps MCP Server

Tools Exposed

Pipelines

Triggers / Schedules

Datasets & Linked Services

Factory

Requirements

• Python 3.9+

• An Azure subscription with a Data Factory instance

• Azure CLI installed and authenticated

• Claude Desktop (or any MCP-compatible client)

Setup

1. Clone and install

git clone https://github.com/nachiketap11/azure-adf-mcp
cd azure-adf-mcp

python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

pip install -r requirements.txt

2. Configure environment

cp .env.example .env

Edit .env with your values:

AZURE_SUBSCRIPTION_ID=your-subscription-id
AZURE_RESOURCE_GROUP=your-resource-group
AZURE_FACTORY_NAME=your-factory-name

3. Authenticate

az login

The server uses DefaultAzureCredential — Azure CLI login is all you need locally.

4. Test the server

python3 src/server.py

You should see: Starting Azure ADF MCP Server...

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "azure-adf": {
      "command": "/absolute/path/to/.venv/bin/python3",
      "args": ["/absolute/path/to/azure-adf-mcp/src/server.py"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id",
        "AZURE_RESOURCE_GROUP": "your-resource-group",
        "AZURE_FACTORY_NAME": "your-factory-name"
      }
    }
  }
}

Restart Claude Desktop. You should see the 🔨 icon in the chat input bar with azure-adf tools listed.

Project Structure

azure-adf-mcp/
├── src/
│   ├── server.py           # MCP server — tool definitions + routing
│   └── azure_client.py     # Azure SDK wrapper with clean JSON outputs
├── .env.example
├── requirements.txt
└── README.md

Extending This Project

• Wrap with FastAPI to expose as an HTTP MCP server for remote deployment

• Add Pytest fixtures with mocked Azure SDK responses for CI

• Deploy to Azure Container Apps for persistent hosting

Auth Reference

DefaultAzureCredential tries credentials in this order:

1. Environment variables (AZURE_CLIENT_ID / AZURE_TENANT_ID / AZURE_CLIENT_SECRET)

2. Workload identity (AKS)

3. Managed identity

4. Azure CLI (az login) ← recommended for local development

5. VS Code credentials

License

MIT