DurableTask.Mcp

A Model Context Protocol (MCP) server for debugging, monitoring, and troubleshooting Durable Task Framework (DTFx) orchestrations stored in Azure Storage.

Note: This project is currently a work in progress. More storage providers coming soon!

Features

Installation

As a .NET Tool (Recommended)

dotnet tool install --global DurableTask.Mcp

Once installed, run the tool using:

dtfx-mcp --storage-account <your-storage-account>

Using dnx (MCP Runner)

If you have dnx installed, you can run the tool directly without installing it globally:

dnx DurableTask.Mcp -- --storage-account <your-storage-account>

Or with logging enabled:

dnx DurableTask.Mcp -- --storage-account <your-storage-account> --log-file ./dtfx-mcp.log

From Source

git clone https://github.com/MoaidHathot/DurableTasksMcp.git
cd DurableTasksMcp/src
dotnet build
dotnet run -- --storage-account <your-storage-account>

Prerequisites

• .NET 10.0 SDK or later
• Azure Storage account with DTFx data
• Azure credentials configured (Azure CLI, environment variables, or managed identity)

Configuration

Storage Account (Required)

Provide the Azure Storage account name via command line or environment variable:

# Command line
dtfx-mcp --storage-account mystorageaccount
dtfx-mcp -s mystorageaccount

# Environment variable
export DTFX_STORAGE_ACCOUNT=mystorageaccount
dtfx-mcp

Logging (Optional)

Enable file logging for debugging:

# Command line
dtfx-mcp -s mystorageaccount --log-file ./dtfx-mcp.log
dtfx-mcp -s mystorageaccount -l ./dtfx-mcp.log

# Environment variable
export DTFX_LOG_FILE=./dtfx-mcp.log
dtfx-mcp -s mystorageaccount

Authentication

The server uses DefaultAzureCredential which supports:

• Azure CLI (az login)
• Environment variables (AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET)
• Managed Identity (when running in Azure)
• Visual Studio / VS Code credentials

Required Azure RBAC Permissions

Your identity needs these roles on the storage account:

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "durable-tasks": {
      "command": "dtfx-mcp",
      "args": ["-s", "mystorageaccount"]
    }
  }
}

With logging enabled:

{
  "mcpServers": {
    "durable-tasks": {
      "command": "dtfx-mcp",
      "args": ["-s", "mystorageaccount", "-l", "/path/to/dtfx-mcp.log"]
    }
  }
}

Using dnx

You can also configure Claude Desktop to use dnx to run the tool:

{
  "mcpServers": {
    "durable-tasks": {
      "command": "dnx",
      "args": ["DurableTask.Mcp", "--", "-s", "mystorageaccount"]
    }
  }
}

Available Tools

Task Hub Tools

Orchestration Tools

History Tools

Queue Tools

Blob Tools

Example Prompts

Once connected via an MCP client, try these:

• "List all task hubs in my storage account"
• "Show me all failed orchestrations in MyTaskHub"
• "Get the execution history for orchestration instance abc-123"
• "What activities failed in this orchestration?"
• "Show me the queue depths for all control queues"
• "Search for orchestrations starting with 'order-'"

DTFx Storage Structure

The MCP server reads from these Azure Storage resources:

Tables

Queues

Blob Containers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Moaid Hathot

• GitHub: @MoaidHathot