使用说明

'fabric-cli-plugin' 是一个为 Anthropic Claude 桌面版和 Claude Code 设计的扩展，它提供了一系列 MCP 服务器和工具，使 AI 代理能够通过自然语言与 Microsoft Fabric 环境进行交互。这些服务器和工具允许 AI 代理查询、创建、修改 Fabric 工作区、数据项以及执行 Power BI 语义模型操作。

主要功能点

• Microsoft Fabric CLI 自动化: 通过 MCP 服务器，AI 代理可以执行与 Fabric CLI 相关的多种操作，包括管理工作区、列出、获取和导出 Fabric 数据项。
• Power BI 语义模型操作: 提供了专门的 MCP 服务器，用于高级的 Power BI 语义模型管理，例如执行 DAX 查询、创建 Direct Lake 模型以及将语义模型导出为 PBIP 格式。
• Lakehouse 文件管理: 能够下载 Fabric Lakehouse 中的文件和导出表结构。
• 自定义技能和工具: 包含一个技能包，为 Claude Code 提供 Fabric CLI 的使用指导和模式，并封装了多达17种用于Fabric操作的工具。

安装步骤

该仓库主要提供了两种MCP服务器（Fabric CLI MCP 和 Power BI Modeling MCP），适用于不同的 Claude 客户端。

前置条件:

• uv 包管理器: MCP 服务器的运行需要安装 'uv'。
  • macOS: 'brew install uv'
  • Windows: 'winget install astral-sh.uv'
• Microsoft Fabric CLI (fab CLI): 需要安装 'fab CLI' (通常通过 'pip install fabric-cli')，并通过 'fab auth login' 进行身份验证。
• Azure 存储相关库 (可选，仅下载 Lakehouse 文件时需要): 'azure-storage-file-datalake' 和 'azure-identity'。

1. 适用于 Claude 桌面版:

• 下载服务器捆绑包:
  • Fabric CLI MCP: 访问仓库的 'claude-desktop/' 目录，下载 'fabric-cli-mcp.mcpb' 文件。
  • Power BI Modeling MCP: 访问仓库的 'claude-desktop/' 目录，下载 'powerbi-modeling-mcp.mcpb' 文件。
• 安装到 Claude 桌面版:
  1. 打开 Claude 桌面版。
  2. 前往 设置 > 扩展。
  3. 将下载的 '.mcpb' 文件拖放到该页面。
  4. 仔细阅读并审查扩展的权限，然后点击 安装。
• 安装技能 (可选，提供上下文和指导):
  1. 下载仓库中 'claude-desktop/fabric-cli-skill.zip' 文件。
  2. 打开 Claude 桌面版，前往 设置 > 能力 > 技能。
  3. 点击 上传技能，选择下载的 ZIP 文件。 注意：此功能可能需要Claude Pro、Max、Team或Enterprise计划。

2. 适用于 Claude Code (作为插件安装):

• Claude Code 通常通过其内置的插件市场安装。
• 添加市场源: 在 Claude Code 命令行中执行 '/plugin marketplace add data-goblin/fabric-cli-plugin'。
• 安装插件: 在 Claude Code 命令行中执行 '/plugin install fabric-cli-plugin@data-goblin'。
• 或者，可以通过 '/plugin' 命令打开插件浏览器，然后选择安装此插件。
• 注意：Claude Code 通常直接调用 Bash 工具与 Fabric CLI 交互，可能不需要显式配置独立的 MCP 服务器。

服务器配置 (MCP 客户端使用示例)

MCP 服务器以 '.mcpb' 捆绑包的形式提供。当 MCP 客户端（如 Claude Desktop）加载此捆绑包时，它会自动从捆绑包内部的 'manifest.json' 文件中提取启动配置。以下是 'powerbi-modeling-mcp.mcpb' 捆绑包中定义的服务器启动配置示例，展示了 MCP 客户端所需的信息：

• 服务器名称 (name): 'powerbi-modeling-mcp' （这是在 '.mcpb' 捆绑包的 'manifest.json' 中定义的名称，客户端加载后会识别此名称。）
• 启动命令 (command): 客户端会执行该命令来启动 MCP 服务器。例如，'powerbi-modeling-mcp.exe'。'"${__dirname}"' 是一个占位符，表示 '.mcpb' 捆绑包解压后的根目录。
• 启动参数 (args): 传递给服务器启动命令的参数列表。例如，'["--start", "--skipconfirmation"]'，这些参数指示 Power BI Modeling MCP 服务器启动并跳过确认提示。
• 环境变量 (env): 一个字典，包含服务器启动时需要设置的环境变量。例如，'{}' 表示当前没有特定的环境变量。

请注意： 如果您是 Claude Desktop 用户，在安装 '.mcpb' 文件后，Claude Desktop 会自动处理这些配置，您无需手动进行 JSON 配置或命令行操作。

基本使用方法

安装完成后，AI 代理（如 Claude）将能够识别并使用这些 MCP 服务器提供的工具。您可以通过自然语言提示 AI 代理执行以下任务：

• 管理 Fabric 项: "列出我的'Sales'工作区中的所有报表。"
• 执行 DAX 查询: "在'Sales Model'语义模型中，执行DAX查询 'EVALUATE TOPN(5, 'Orders')' 并显示结果。"
• 导出数据: "将 'Production.Workspace' 中的 'Sales Model.SemanticModel' 导出为 PBIP 文件到我的本地 '/tmp/exports' 目录。"
• 创建 Direct Lake 模型: "从 'src.Workspace/LH.Lakehouse' 的 'schema.table' 表创建一个名为 'NewSalesModel' 的 Direct Lake 语义模型到 'dest.Workspace'。"
• 下载工作区内容: "下载 'Dev.Workspace' 的所有内容到本地文件夹，包括 Lakehouse 文件。"