Durable Tasks MCP

持久任务。主控程序

用于调试、监控和故障排除的模型上下文协议（MCP）服务器 持久任务框架（DTFx） 存储在Azure存储中的编排。

注： 该项目目前正在进行中。更多存储提供商即将推出！

特性

安装

作为一个。NET工具（推荐）

dotnet tool install --global DurableTask.Mcp

安装后，使用以下命令运行该工具：

dtfx-mcp --storage-account 

使用dnx（MCP Runner）

如果你有 DNX 安装后，您可以直接运行该工具，而无需全局安装：

dnx DurableTask.Mcp -- --storage-account 

或者启用日志记录：

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

来源

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

先决条件

• .NET 10.0 SDK或更高版本
• 具有DTFx数据的Azure存储帐户
• 已配置Azure凭据（Azure CLI、环境变量或托管身份）

配置

存储帐户（必填）

通过命令行或环境变量提供Azure存储帐户名：

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

# Environment variable
export DTFX_STORAGE_ACCOUNT=mystorageaccount
dtfx-mcp

日志记录（可选）

启用调试文件日志记录：

# 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

认证

服务器使用 DefaultAzureCredential 它支持：

• Azure命令行界面(az login)
• 环境变量(AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET)
• 托管身份（在Azure中运行时）
• Visual Studio/VS代码凭据

所需的Azure RBAC权限

您的身份需要存储帐户上的以下角色：

MCP客户端配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

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

启用日志记录后：

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

使用dnx

您还可以配置Claude Desktop以使用 dnx 要运行该工具，请执行以下操作：

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

可用工具

任务中心工具

编排工具

历史记录工具

队列工具

Blob工具

示例提示

一旦通过MCP客户端连接，请尝试以下操作：

• *“列出我的存储帐户中的所有任务中心”*
• *“在MyTaskHub中显示所有失败的业务流程”*
• *“获取编排实例abc-123的执行历史记录”*
• *“此编排中有哪些活动失败？”*
• *“显示所有控制队列的队列深度”*
• *“搜索以“order-”开头的业务流程”*

DTFx存储结构

MCP服务器从这些Azure存储资源中读取：

表格

队列

Blob容器

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

作者

哈特特湖

• github： @MoaidHathot