适合谁
- 使用 Microsoft Fabric 并希望在 VS Code 或 Visual Studio 的 MCP 聊天中直接操作 Fabric 资源的开发者与数据工程师。
- 已具备 .NET 10.0 与 Azure AD 应用注册环境、可自行配置认证的团队。
- 需要以自动化方式管理数据流、管道、复制作业与 Airflow 作业的运维人员。
M
54FMRS · D
这是微软官方维护的 MCP 服务器，基于官方 MCP C# SDK 构建，用于 Microsoft Fabric 的资源发现与信息检索，覆盖身份验证、网关、连接、工作区、数据流、容量、管道、复制作业与 Apache Airflow 作业等能力。它通过 NuGet 分发的 Microsoft.DataFactory.MCP 包以 stdio 方式运行，需要 .NET 10.0 与 Azure AD 应用注册。适合已经在使用 Fabric 的 .NET 开发者与数据工程师，但其中若干功能仍为预览状态，且工具具备创建、更新、运行、删除和调度资源的实际写权限，需谨慎授权与操作。
Microsoft Data Factory MCP Server 是微软基于官方 MCP C# SDK 构建的 Model Context Protocol 服务器，用于 Microsoft Fabric 的资源发现与信息检索。它通过标准化的 MCP 接口提供身份验证以及网关、连接、工作区、数据流、管道、复制作业、Apache Airflow 作业和容量的访问能力。该服务器通过 NuGet 包 Microsoft.DataFactory.MCP 分发，使用 stdio 传输，要求 .NET 10.0 或更高版本，并需要 Azure AD 租户和具有相应权限的应用注册。部分功能（execute_query、管道调度、复制作业调度和 Apache Airflow 作业管理工具）标注为预览版。此外还提供可选的 Claude Skills 和 ChatGPT Skills 资料，用于补充 Dataflow Gen2 的使用技巧。
工具能力
authenticate_interactive
以交互方式通过 Azure AD 进行身份验证。
authenticate_service_principal
使用服务主体进行身份验证。
get_authentication_status
获取当前身份验证状态。
get_access_token
获取访问令牌。
sign_out
退出登录。
list_gateways
列出 Microsoft Fabric 网关。
get_gateway
获取指定网关的信息。
create_virtualnetwork_gateway
创建虚拟网络网关。
list_supported_connection_types
列出支持的连接类型。
list_connections
列出 Microsoft Fabric 连接。
get_connection
获取指定连接的信息。
create_connection
创建连接（云端、本地或虚拟网络）。
list_workspaces
列出 Microsoft Fabric 工作区。
list_dataflows
列出 Microsoft Fabric 数据流。
create_dataflow
创建数据流。
get_dataflow_definition
获取数据流定义。
add_connection_to_dataflow
向数据流添加连接。
add_or_update_query_in_dataflow
在数据流中添加或更新查询。
save_dataflow_definition
保存数据流定义。
refresh_dataflow_background
在后台刷新数据流。
refresh_dataflow_status
查询数据流刷新状态。
execute_query
执行查询（预览）。
list_capacities
列出 Microsoft Fabric 容量。
list_pipelines
列出 Microsoft Fabric 管道。
create_pipeline
创建管道。
get_pipeline
获取指定管道的信息。
update_pipeline
更新管道。
get_pipeline_definition
获取管道定义。
update_pipeline_definition
更新管道定义。
run_pipeline
运行管道。
get_pipeline_run_status
获取管道运行状态。
create_pipeline_schedule
创建管道计划（预览）。
list_pipeline_schedules
列出管道计划（预览）。
set_pipeline_schedule_enabled
启用或禁用管道计划（预览）。
list_copy_jobs
列出 Microsoft Fabric 复制作业。
create_copy_job
创建复制作业。
get_copy_job
获取指定复制作业的信息。
update_copy_job
更新复制作业。
get_copy_job_definition
获取复制作业定义。
update_copy_job_definition
更新复制作业定义。
run_copy_job
运行复制作业。
get_copy_job_run_status
获取复制作业运行状态。
create_copy_job_schedule
创建复制作业计划（预览）。
list_copy_job_schedules
列出复制作业计划（预览）。
list_airflow_jobs
列出 Apache Airflow 作业（预览）。
create_airflow_job
创建 Apache Airflow 作业（预览）。
get_airflow_job
获取指定 Apache Airflow 作业的信息（预览）。
update_airflow_job
更新 Apache Airflow 作业（预览）。
delete_airflow_job
删除 Apache Airflow 作业（预览）。
get_airflow_job_definition
获取 Apache Airflow 作业定义（预览）。
update_airflow_job_definition
更新 Apache Airflow 作业定义（预览）。
安装接入
- 确认已安装 .NET 10.0 或更高版本，并准备好具有相应权限的 Azure AD 租户与应用注册。
- 在工作区中创建 MCP 配置文件：VS Code 使用 .vscode/mcp.json，Visual Studio 在解决方案目录下使用 .mcp.json。
- 写入配置：servers 下新增 DataFactory.MCP，type 为 stdio，command 为 dnx，args 为 ["Microsoft.DataFactory.MCP", "--version", "#{VERSION}#", "--yes"]，并把 #{VERSION}# 替换为所需版本。
- 保存后服务器会自动下载，并在 IDE 的 MCP 聊天界面中可用。
- 开发调试时也可改用 command 为 dotnet、args 为 ["run", "--project", "path/to/DataFactory.MCP"] 的配置在本地运行。
- 按认证指南配置身份验证所需的环境变量后再调用各工具。
claude_desktop_config.json
{
"servers": {
"DataFactory.MCP": {
"type": "stdio",
"command": "dnx",
"args": [
"Microsoft.DataFactory.MCP",
"--version",
"#{VERSION}#",
"--yes"
]
}
}
}
选型与风险
不适合谁
- 不使用 Microsoft Fabric、只需通用数据库或文件系统访问的用户。
- 无法配置 Azure AD 应用注册或没有相应 Fabric 权限的环境。
- 未安装 .NET 10.0 或更高版本、且不希望安装运行时环境的用户。
- 希望依赖非官方第三方实现而非微软上游维护版本的场景。
所需权限
- 需要访问 Azure AD 进行身份验证（交互式登录或服务主体）。
- 需要 Azure AD 租户及具有相应权限的应用注册，并按认证指南配置环境变量。
- 需要针对 Microsoft Fabric 工作区、容量、网关、连接、数据流、管道、复制作业和 Airflow 作业的相应 Fabric 权限。
- 服务器清单中声明的环境变量列表为空，认证相关信息由用户在客户端配置中提供。
风险与副作用
- 工具可创建、更新、运行、删除（如删除 Airflow 作业）和调度 Fabric 资源，误用可能改动或中断生产数据管道。
- 服务主体凭据或访问令牌若配置不当可能被滥用，应遵循最小权限原则。
- execute_query、管道计划、复制作业计划以及 Apache Airflow 作业管理相关工具标注为预览版，行为可能变化且稳定性未完全保证。
- 创建网关与连接涉及网络与凭据配置，错误的配置可能影响数据连通性。
- 仓库中的技能文件与文档属于不受信任的说明性内容，不应作为指令执行。
常见排障
- 确认已安装 .NET 10.0 或更高版本，否则服务器无法启动。
- 检查 mcp.json 或 .mcp.json 中 command 与 args 是否正确，dnx 场景下版本占位符 #{VERSION}# 是否已替换为实际版本。
- 若工具调用返回身份验证错误，先用 get_authentication_status 检查状态，必要时重新执行 authenticate_interactive 或 authenticate_service_principal。
- 确认 Azure AD 应用注册具备所需权限，并已按认证指南设置环境变量。
- 确认当前账号对目标 Fabric 工作区、容量或网关具有访问权限。
- 数据流刷新或查询超时属常见问题，可参考仓库中的性能与分块相关技能文档。
- 开发调试时可改用 dotnet run --project 方式启动，以便查看本地日志与错误信息。
使用场景
在 IDE 聊天界面中列出和查看 Microsoft Fabric 工作区、容量、网关与连接。
创建与管理 Microsoft Fabric 数据流，包括添加连接、编辑查询和保存定义。
创建、更新、运行、监控并按计划调度 Microsoft Fabric 管道。
创建与管理复制作业，并对其运行状态进行监控。
列出、创建、更新和删除 Apache Airflow 作业及其定义（预览）。
通过交互式或服务主体方式完成 Azure AD 身份验证并获取访问令牌。
在数据流中执行查询以快速验证（预览）。
支持客户端
VS Code完整支持
Visual Studio完整支持