@microsoft/fabric-mcp 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +61 -1
  2. package/package.json +9 -9
package/README.md CHANGED
@@ -11,6 +11,7 @@ A local-first Model Context Protocol (MCP) server that provides AI agents with c
11
11
  - [Usage](#usage)
12
12
  - [Getting Started](#getting-started)
13
13
  - [What can you do with the Fabric MCP Server?](#what-can-you-do-with-the-fabric-mcp-server)
14
+ - [Catalog Discovery](#catalog-discovery)
14
15
  - [Fabric Workloads & APIs](#fabric-workloads--apis)
15
16
  - [Resource Definitions & Schemas](#resource-definitions--schemas)
16
17
  - [Best Practices & Examples](#best-practices--examples)
@@ -18,7 +19,11 @@ A local-first Model Context Protocol (MCP) server that provides AI agents with c
18
19
  - [Available Tools](#available-tools)
19
20
  - [API Documentation & Best Practices](#api-documentation--best-practices)
20
21
  - [OneLake Data Operations](#onelake-data-operations)
22
+ - [OneLake Security — Data Access Roles](#onelake-security--data-access-roles)
23
+ - [OneLake Shortcuts](#onelake-shortcuts)
24
+ - [OneLake Settings](#onelake-settings)
21
25
  - [Core Fabric Operations](#core-fabric-operations)
26
+ - [Data Factory Operations](#data-factory-operations)
22
27
  - [Support and Reference](#support-and-reference)
23
28
  - [Documentation](#documentation)
24
29
  - [Feedback and Support](#feedback-and-support)
@@ -37,6 +42,7 @@ Key capabilities:
37
42
  - **Item Definition Knowledge**: JSON schemas for every Fabric item type (Lakehouses, pipelines, semantic models, notebooks, etc.)
38
43
  - **Built-in Best Practices**: Embedded guidance on pagination, error handling, and recommended patterns
39
44
  - **Local-First Security**: Runs entirely on your machine—never connects to your Fabric environment
45
+ - **Data Factory Integration**: Pipeline and Dataflow Gen2 management with M query execution
40
46
 
41
47
  # Installation
42
48
  - To use Fabric MCP server from node one must have Node.js (LTS) installed and available on your system PATH — this provides both `npm` and `npx`. We recommend Node.js 20 LTS or later. To verify your installation run: `node --version`, `npm --version`, and `npx --version`.
@@ -87,6 +93,13 @@ Key capabilities:
87
93
 
88
94
  The Fabric MCP Server supercharges your agents with Microsoft Fabric context. Here are some prompts you can try:
89
95
 
96
+ ### Catalog Discovery
97
+
98
+ * "Search the OneLake catalog for items related to 'sales revenue'"
99
+ * "Find a Lakehouse with 'customer' in the name across my workspaces"
100
+ * "Discover all Report items in the catalog and show which workspace they live in"
101
+ * "Filter the catalog to Warehouse and Notebook items"
102
+
90
103
  ### Fabric Workloads & APIs
91
104
 
92
105
  * "What are the available Fabric workload types I can work with?"
@@ -151,12 +164,59 @@ The Fabric MCP Server exposes tools organized into three categories:
151
164
  | `onelake_list_tables` | Lists tables published within a namespace. |
152
165
  | `onelake_get_table` | Retrieves the definition for a specific table. |
153
166
 
167
+ ### OneLake Security — Data Access Roles
168
+
169
+ | Tool Name | Description |
170
+ |-----------|-------------|
171
+ | `onelake_list_data_access_roles` | Lists all data access roles defined on a single item. |
172
+ | `onelake_get_data_access_role` | Gets the full definition of a single data access role (members, permissions, decision rules). |
173
+ | `onelake_create_or_update_data_access_role` | Upserts a single data access role on a single item. |
174
+ | `onelake_delete_data_access_role` | Deletes a single data access role from an item. |
175
+
176
+ ### OneLake Shortcuts
177
+
178
+ | Tool Name | Description |
179
+ |-----------|-------------|
180
+ | `onelake_list_shortcuts` | Lists shortcuts defined within an item. Hides DW-managed shortcuts by default (`--include-managed` to show). |
181
+ | `onelake_get_shortcut` | Gets the properties of a single shortcut. |
182
+ | `onelake_create_shortcut_onelake` | Creates a shortcut pointing to another OneLake location. |
183
+ | `onelake_create_shortcut_adls_gen2` | Creates a shortcut pointing to Azure Data Lake Storage Gen2. |
184
+ | `onelake_create_shortcut_amazon_s3` | Creates a shortcut pointing to Amazon S3. |
185
+ | `onelake_create_shortcut_azure_blob` | Creates a shortcut pointing to Azure Blob Storage. |
186
+ | `onelake_create_shortcut_gcs` | Creates a shortcut pointing to Google Cloud Storage. |
187
+ | `onelake_create_shortcut_s3_compatible` | Creates a shortcut pointing to S3-compatible storage. |
188
+ | `onelake_create_shortcut_dataverse` | Creates a shortcut pointing to a Dataverse environment. |
189
+ | `onelake_create_shortcut_onedrive_sharepoint` | Creates a shortcut pointing to OneDrive/SharePoint Online. |
190
+ | `onelake_delete_shortcut` | Deletes a single shortcut from an item (preserves destination data). |
191
+ | `onelake_reset_shortcut_cache` | Drops cached shortcut reads, forcing re-resolution from destination. |
192
+
193
+ ### OneLake Settings
194
+
195
+ | Tool Name | Description |
196
+ |-----------|-------------|
197
+ | `onelake_get_settings` | Gets OneLake settings for a workspace (diagnostics + immutability policy). |
198
+ | `onelake_modify_diagnostics` | Modifies diagnostic logging configuration (status, destination lakehouse) at workspace scope. |
199
+ | `onelake_modify_immutability_policy` | Modifies the workspace-level OneLake immutability policy (scope, retention days). |
200
+
154
201
  ### Core Fabric Operations
155
202
 
156
203
  | Tool Name | Description |
157
204
  |-----------|-------------|
205
+ | `core_search-catalog` | Searches the OneLake catalog for items across workspaces by name, description, or workspace name. Optionally filter by item type. |
158
206
  | `core_create-item` | Creates new Fabric items (Lakehouses, Notebooks, etc.). |
159
207
 
208
+ ### Data Factory Operations
209
+
210
+ | Tool Name | Description |
211
+ |-----------|-------------|
212
+ | `datafactory_list-pipelines` | Lists all pipelines in a Microsoft Fabric workspace. |
213
+ | `datafactory_create-pipeline` | Creates a new pipeline in a workspace. |
214
+ | `datafactory_get-pipeline` | Gets details of a specific pipeline. |
215
+ | `datafactory_run-pipeline` | Runs a pipeline on demand. |
216
+ | `datafactory_list-dataflows` | Lists all Dataflow Gen2 items in a workspace. |
217
+ | `datafactory_create-dataflow` | Creates a new Dataflow Gen2 item. |
218
+ | `datafactory_execute-query` | Executes an M (Power Query) query against a dataflow. |
219
+
160
220
  > Always verify available commands via `--help`. Command names and availability may change between releases.
161
221
 
162
222
  # Support and Reference
@@ -168,7 +228,7 @@ The Fabric MCP Server exposes tools organized into three categories:
168
228
 
169
229
  ## Feedback and Support
170
230
 
171
- - The Microsoft Fabric MCP Server is an **open-source project in Public Preview**. Support for this server implementation is primarily provided through community channels and GitHub repositories. Customers with qualifying Microsoft enterprise support agreements may have access to limited support for broader Microsoft Fabric and platform scenarios; review the [Microsoft Support Policy](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/SUPPORT.md#microsoft-support-policy) section of this project for more details.
231
+ - Support for this server implementation is primarily provided through community channels and GitHub repositories. Customers with qualifying Microsoft enterprise support agreements may have access to limited support for broader Microsoft Fabric and platform scenarios; review the [Microsoft Support Policy](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/SUPPORT.md#microsoft-support-policy) section of this project for more details.
172
232
  - Check the [Troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/TROUBLESHOOTING.md) to diagnose and resolve common issues.
173
233
  - We're building this in the open. Your feedback is much appreciated!
174
234
  - [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we'd love to hear from you!
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@microsoft/fabric-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.2.0",
4
4
  "description": "Microsoft Fabric MCP Server - Model Context Protocol implementation for Fabric",
5
5
  "author": "Microsoft",
6
6
  "homepage": "https://github.com/Microsoft/mcp/blob/main/servers/Fabric.Mcp.Server#readme",
@@ -14,8 +14,8 @@
14
14
  "url": "https://github.com/microsoft/mcp/issues"
15
15
  },
16
16
  "repository": {
17
- "type": "git",
18
- "url": "https://github.com/microsoft/mcp.git"
17
+ "url": "https://github.com/microsoft/mcp.git",
18
+ "type": "git"
19
19
  },
20
20
  "engines": {
21
21
  "node": ">=20.0.0"
@@ -33,12 +33,12 @@
33
33
  "arm64"
34
34
  ],
35
35
  "optionalDependencies": {
36
- "@microsoft/fabric-mcp-linux-x64": "1.0.0",
37
- "@microsoft/fabric-mcp-win32-arm64": "1.0.0",
38
- "@microsoft/fabric-mcp-linux-arm64": "1.0.0",
39
- "@microsoft/fabric-mcp-darwin-x64": "1.0.0",
40
- "@microsoft/fabric-mcp-darwin-arm64": "1.0.0",
41
- "@microsoft/fabric-mcp-win32-x64": "1.0.0"
36
+ "@microsoft/fabric-mcp-darwin-x64": "1.2.0",
37
+ "@microsoft/fabric-mcp-win32-arm64": "1.2.0",
38
+ "@microsoft/fabric-mcp-win32-x64": "1.2.0",
39
+ "@microsoft/fabric-mcp-linux-x64": "1.2.0",
40
+ "@microsoft/fabric-mcp-darwin-arm64": "1.2.0",
41
+ "@microsoft/fabric-mcp-linux-arm64": "1.2.0"
42
42
  },
43
43
  "scripts": {
44
44
  "postinstall": "node ./scripts/post-install-script.js"