msfabric-mcp

一个用于 Microsoft Fabric 的 Model Context Protocol 服务器，基于 stdio，使用 Python 实现。

它通过一个连接为智能体提供 Fabric 的两个部分：

• 控制平面，通过 api.fabric.microsoft.com/v1 上的公共 REST API（工作区、项、湖屋、仓库、笔记本、作业调度器），以及

• 数据平面，通过仓库或湖屋的 SQL 分析端点，并受只读白名单守卫的保护。

另外还支持对 Power BI 语义模型执行可选的 DAX。

默认只读。除非操作者设置 FABRIC_ALLOW_WRITES，否则拒绝所有写入；即使设置了，UPDATE 和 DELETE 也必须带有 WHERE。

• 包：msfabric-mcp（位于 PyPI）

• 仓库：https://github.com/NawafSheikh/fabric-mcp

• MCP 注册表名称：io.github.nawafsheikh/msfabric-mcp

• 许可证：MIT

坦诚的定位

截至 2026-08-22，Fabric MCP 领域已经相当拥挤。下面列出已有的实现以及本项目的区别。以下内容并非在声称其他实现不好。

msfabric-mcp 的定位：

1. 一个服务器横跨两个平面。 Microsoft 的 Core MCP 服务器仅覆盖控制平面；要运行查询，你还需要另一个工具。在这里，list_items 和 run_sql 位于同一进程、使用同一凭据。

2. 本地 stdio，无需加入预览。 Microsoft 的服务器是远程的且处于预览阶段。本服务器在你的机器上运行，使用正式发布的 REST API，因此你能够登录的任何租户都可以使用。

3. 守卫即产品。 run_sql 是白名单，而不是黑名单：只有当语句被明确归类为读取（或在启用写入时被归类为允许的写入）才会执行。首先剥离注释，拒绝语句批处理，并且在任何模式下都拒绝存储过程执行、OPENROWSET/OPENQUERY、GRANT/REVOKE、BACKUP/RESTORE 和 SHUTDOWN。

4. 输出有界。 每个结果集在行数和单元格宽度上都有限制，并在截断时予以说明，因此宽泛的 SELECT * 不会淹没上下文窗口。

如果你只需要在已启用预览的租户内浏览控制平面，请使用 Microsoft 的 Core MCP 服务器；它是第一方产品，并且总能更快地跟进 API。当你希望在本地、在同一个服务器中同时使用 SQL 和作业，并希望默认严格只读时，请使用本服务器。

Related MCP server: Databricks MCP Server

安装

pip install msfabric-mcp

SQL 访问需要一个驱动程序。请选择一种：

pip install "msfabric-mcp[sql]"     # pyodbc, plus ODBC Driver 18 for SQL Server
pip install "msfabric-mcp[mssql]"   # mssql-python, no external ODBC manager

• pyodbc 需要单独安装 ODBC Driver 18 for SQL Server（17 也可用）。Entra 令牌通过 SQL_COPT_SS_ACCESS_TOKEN 连接属性（1256）传递。

• mssql-python 是 Microsoft 自家的驱动程序，需要 Python 3.10+，通过 wheel 安装其连接层，并支持 Fabric Data Warehouse 和 Lakehouse SQL 分析端点。

REST 工具不需要任何驱动程序。你可以在完全不配置 SQL 的情况下运行服务器，仍然可以浏览工作区、项和作业。

需要 Python 3.11 或更高版本。

配置

所有内容都来自环境变量。与租户、工作区、仓库或主机相关的任何信息都不会编译进包中。参见 .env.example。

身份验证

三种模式，全部基于 azure-identity。

1. DefaultAzureCredential（默认）。 无需设置任何内容。凭据链会采用 az login 会话、VS Code 登录、托管标识，或通过标准的 AZURE_CLIENT_ID / AZURE_TENANT_ID / AZURE_CLIENT_SECRET 环境变量配置的服务主体。

az login

2. 服务主体。 设置全部三项后，模式会自动推断：

服务主体必须以管理员、成员或参与者身份添加到工作区，并且租户设置 服务主体可调用 Fabric 公共 API 必须处于开启状态。

3. 设备代码，适用于无头计算机或 SSH 会话：

FABRIC_AUTH_MODE=device_code
FABRIC_CLIENT_ID=<a public client app registration>

令牌按作用域缓存在内存中，并在过期前两分钟刷新。它们绝不会写入磁盘，不会被记录，也绝不会出现在服务器返回的任何错误消息中。

作用域与 SQL

安全

任何机密都不会被打印。health 只报告租户 ID、客户端 ID 和机密是否已配置，绝不会报告它们的值；错误消息只包含异常类和一段简短的详细信息，并已去除查询字符串。

客户端配置

Claude Desktop、Claude Code 或任何 stdio MCP 客户端：

{
  "mcpServers": {
    "fabric": {
      "command": "msfabric-mcp",
      "env": {
        "FABRIC_WORKSPACE_ID": "00000000-0000-0000-0000-000000000000",
        "FABRIC_SQL_ENDPOINT": "your-endpoint.datawarehouse.fabric.microsoft.com",
        "FABRIC_SQL_DATABASE": "your_warehouse"
      }
    }
  }
}

不要将 FABRIC_CLIENT_SECRET 放在位于仓库中的配置文件中。请使用 az login、托管标识或能够将变量注入服务器进程的机密管理器。

工具

笔记本和湖屋参数接受显示名称或 ID；名称会通过 list_items 即时解析。

SQL 防护机制详解

run_sql 每次调用接受一条语句，在做出任何判断之前会先去除注释。然后：

• 以 SELECT 或 WITH 开头，且不包含 SELECT ... INTO 或 FOR UPDATE：归类为读取，始终允许。

• 以 INSERT、UPDATE、DELETE、MERGE、CREATE、ALTER、DROP、TRUNCATE 开头，或是 SELECT ... INTO：归类为写入。除非设置了 FABRIC_ALLOW_WRITES，否则拒绝。即使启用了写入，UPDATE 和 DELETE 还额外要求包含 WHERE 子句。

• 其他任何情况：拒绝，因为不符合上述两种形态。

• EXEC/EXECUTE、sp_*、xp_*、OPENROWSET、OPENDATASOURCE、OPENQUERY、BULK INSERT、GRANT、REVOKE、DENY、BACKUP、RESTORE、SHUTDOWN、RECONFIGURE：在所有模式下均拒绝。

• 以 ; 分隔的多条语句：拒绝，以便每条语句单独判断。

提供给 describe_table 的表名和架构名会作为普通标识符进行验证，且查询本身是参数化的，因此名称无法携带 SQL。

这是针对代理失误的防护，而非权限的替代品。为身份授予其所需的最低访问权限；工作区角色和仓库自身的对象权限仍然是真正的边界。

关于 execute_dax 的说明

使用 JSON executeQueries 端点，而非较新的 Arrow executeDaxQueries，因为 executeQueries 适用于 Pro、PPU 和 Premium/Fabric 容量，且无需 Arrow 库。其文档规定的上限为每个查询 100,000 行和 1,000,000 个值；FABRIC_MAX_ROWS 在此基础上进一步限制。必须启用租户设置 Dataset Execute Queries REST API，且调用方需要对语义模型具有 Build 权限。仅接受 EVALUATE 和 DEFINE 查询。

涉及的外部资源

• 向 api.fabric.microsoft.com、api.powerbi.com 和 Microsoft Entra 发起出站 HTTPS 请求以获取令牌。

• 仅在调用 SQL 工具且设置了 FABRIC_SQL_ENDPOINT 时，通过 1433 端口向 SQL 分析端点发起出站 TDS 连接。Encrypt=yes、TrustServerCertificate=no。

• 不写入本地文件系统。无遥测。无第三方服务。

开发

git clone https://github.com/NawafSheikh/fabric-mcp
cd fabric-mcp
pip install -e ".[dev]"
pytest
python -m build

整个测试套件在无网络、无 Fabric 租户、未安装 ODBC 驱动的情况下运行：REST 调用通过 httpx.MockTransport 进行，SQL 层接受可注入的连接工厂，测试用假的 DB-API 连接来填充。

贡献

欢迎在 https://github.com/NawafSheikh/fabric-mcp/issues 提交 Issue 和 Pull Request。

参考来源

检查日期：2026-08-22。

• Fabric REST API：项目

• Fabric REST API：工作区

• Fabric REST API：作业计划程序

• 使用 API 在 Fabric 中管理和执行笔记本

• 使用 REST API 管理湖屋（列出表）

• OneLake 目录和 Fabric REST API

• mssql-python 支持生命周期（Fabric 端点）

• Microsoft Python Driver for SQL Server

• Azure Identity client library for Python

• Power BI：执行查询

• Power BI：执行 DAX 查询（Arrow）概述

• Fabric Core MCP Server 工具参考

• 远程 Power BI MCP 服务器