@microsoft/fabric-mcp-linux-x64 0.0.0-beta.9 → 1.1.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.
- package/README.md +83 -52
- package/dist/fabmcp +0 -0
- package/package.json +1 -1
- package/dist/appsettings.json +0 -5
package/README.md
CHANGED
|
@@ -5,17 +5,29 @@ A local-first Model Context Protocol (MCP) server that provides AI agents with c
|
|
|
5
5
|
## Table of Contents
|
|
6
6
|
- [Overview](#overview)
|
|
7
7
|
- [Installation](#installation)
|
|
8
|
+
- [IDE](#ide)
|
|
9
|
+
- [VS Code (Recommended)](#vs-code-recommended)
|
|
10
|
+
- [Manual Setup](#manual-setup)
|
|
8
11
|
- [Usage](#usage)
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
- [
|
|
12
|
+
- [Getting Started](#getting-started)
|
|
13
|
+
- [What can you do with the Fabric MCP Server?](#what-can-you-do-with-the-fabric-mcp-server)
|
|
14
|
+
- [Fabric Workloads & APIs](#fabric-workloads--apis)
|
|
15
|
+
- [Resource Definitions & Schemas](#resource-definitions--schemas)
|
|
16
|
+
- [Best Practices & Examples](#best-practices--examples)
|
|
17
|
+
- [Development Workflows](#development-workflows)
|
|
18
|
+
- [Available Tools](#available-tools)
|
|
19
|
+
- [API Documentation & Best Practices](#api-documentation--best-practices)
|
|
20
|
+
- [OneLake Data Operations](#onelake-data-operations)
|
|
21
|
+
- [Core Fabric Operations](#core-fabric-operations)
|
|
22
|
+
- [Data Factory Operations](#data-factory-operations)
|
|
12
23
|
- [Support and Reference](#support-and-reference)
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
24
|
+
- [Documentation](#documentation)
|
|
25
|
+
- [Feedback and Support](#feedback-and-support)
|
|
26
|
+
- [Security](#security)
|
|
27
|
+
- [Data Collection](#data-collection)
|
|
28
|
+
- [Contributing](#contributing)
|
|
29
|
+
- [Code of Conduct](#code-of-conduct)
|
|
30
|
+
- [License](#license)
|
|
19
31
|
|
|
20
32
|
# Overview
|
|
21
33
|
|
|
@@ -26,6 +38,7 @@ Key capabilities:
|
|
|
26
38
|
- **Item Definition Knowledge**: JSON schemas for every Fabric item type (Lakehouses, pipelines, semantic models, notebooks, etc.)
|
|
27
39
|
- **Built-in Best Practices**: Embedded guidance on pagination, error handling, and recommended patterns
|
|
28
40
|
- **Local-First Security**: Runs entirely on your machine—never connects to your Fabric environment
|
|
41
|
+
- **Data Factory Integration**: Pipeline and Dataflow Gen2 management with M query execution
|
|
29
42
|
|
|
30
43
|
# Installation
|
|
31
44
|
- 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`.
|
|
@@ -70,27 +83,27 @@ Key capabilities:
|
|
|
70
83
|
- The agent should be able to use the Fabric MCP Server tools to complete your query
|
|
71
84
|
1. Check out the [Microsoft Fabric documentation](https://learn.microsoft.com/fabric/) and review the [troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/TROUBLESHOOTING.md) for commonly asked questions
|
|
72
85
|
1. We're building this in the open. Your feedback is much appreciated!
|
|
73
|
-
-
|
|
86
|
+
- [Open an issue in the public repository](https://github.com/microsoft/mcp/issues/new/choose)
|
|
74
87
|
|
|
75
88
|
## What can you do with the Fabric MCP Server?
|
|
76
89
|
|
|
77
|
-
|
|
90
|
+
The Fabric MCP Server supercharges your agents with Microsoft Fabric context. Here are some prompts you can try:
|
|
78
91
|
|
|
79
|
-
###
|
|
92
|
+
### Fabric Workloads & APIs
|
|
80
93
|
|
|
81
94
|
* "What are the available Fabric workload types I can work with?"
|
|
82
95
|
* "Show me the OpenAPI operations for 'notebook' and give a sample creation body"
|
|
83
96
|
* "Get the platform-level API specifications for Microsoft Fabric"
|
|
84
97
|
* "List all supported Fabric item types"
|
|
85
98
|
|
|
86
|
-
###
|
|
99
|
+
### Resource Definitions & Schemas
|
|
87
100
|
|
|
88
101
|
* "Create a Lakehouse resource definition with a schema that enforces a string column and a datetime column"
|
|
89
102
|
* "Show me the JSON schema for a Data Pipeline item definition"
|
|
90
103
|
* "Generate a Semantic Model configuration with sample measures"
|
|
91
104
|
* "What properties are required for creating a KQL Database?"
|
|
92
105
|
|
|
93
|
-
###
|
|
106
|
+
### Best Practices & Examples
|
|
94
107
|
|
|
95
108
|
* "Show me best practices for handling API throttling in Fabric"
|
|
96
109
|
* "How should I implement retry logic for Fabric API rate limits?"
|
|
@@ -99,7 +112,7 @@ Key capabilities:
|
|
|
99
112
|
* "Get example request/response payloads for creating a Notebook"
|
|
100
113
|
* "What are the pagination patterns for Fabric REST APIs?"
|
|
101
114
|
|
|
102
|
-
###
|
|
115
|
+
### Development Workflows
|
|
103
116
|
|
|
104
117
|
* "Generate a data pipeline configuration with sample data sources"
|
|
105
118
|
* "Help me scaffold a Fabric workspace with Lakehouse and notebooks"
|
|
@@ -108,40 +121,58 @@ Key capabilities:
|
|
|
108
121
|
|
|
109
122
|
## Available Tools
|
|
110
123
|
|
|
111
|
-
The Fabric MCP Server exposes
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
|
116
|
-
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
124
|
+
The Fabric MCP Server exposes tools organized into three categories:
|
|
125
|
+
|
|
126
|
+
### API Documentation & Best Practices
|
|
127
|
+
|
|
128
|
+
| Tool Name | Description |
|
|
129
|
+
|-----------|-------------|
|
|
130
|
+
| `docs_workloads` | Lists Fabric workload types that have public API specifications available. |
|
|
131
|
+
| `docs_workload-api-spec` | Retrieves the complete OpenAPI specification for a specific Fabric workload. |
|
|
132
|
+
| `docs_platform-api-spec` | Retrieves the OpenAPI specification for core Fabric platform APIs. |
|
|
133
|
+
| `docs_item-definitions` | Retrieves JSON schema definitions for items in a Fabric workload API. |
|
|
134
|
+
| `docs_best-practices` | Retrieves best practice documentation and guidance for a specific topic. |
|
|
135
|
+
| `docs_api-examples` | Retrieves example API request/response files for a specific workload. |
|
|
136
|
+
|
|
137
|
+
### OneLake Data Operations
|
|
138
|
+
|
|
139
|
+
| Tool Name | Description |
|
|
140
|
+
|-----------|-------------|
|
|
141
|
+
| `onelake_list_workspaces` | Lists available Microsoft Fabric workspaces. |
|
|
142
|
+
| `onelake_list_items` | Lists workspace items with high-level metadata. |
|
|
143
|
+
| `onelake_list_items_dfs` | Lists Fabric items via the DFS endpoint. |
|
|
144
|
+
| `onelake_list_files` | Lists files using the hierarchical file-list endpoint. |
|
|
145
|
+
| `onelake_download_file` | Downloads a OneLake file. |
|
|
146
|
+
| `onelake_upload_file` | Uploads a file to OneLake storage. |
|
|
147
|
+
| `onelake_delete_file` | Deletes a file from OneLake storage. |
|
|
148
|
+
| `onelake_create_directory` | Creates a directory via the DFS endpoint. |
|
|
149
|
+
| `onelake_delete_directory` | Deletes a directory (optionally recursive). |
|
|
150
|
+
| `onelake_get_table_config` | Retrieves table API configuration for a workspace item. |
|
|
151
|
+
| `onelake_list_table_namespaces` | Lists table namespaces (schemas) exposed through the table API. |
|
|
152
|
+
| `onelake_get_table_namespace` | Retrieves metadata for a specific namespace. |
|
|
153
|
+
| `onelake_list_tables` | Lists tables published within a namespace. |
|
|
154
|
+
| `onelake_get_table` | Retrieves the definition for a specific table. |
|
|
155
|
+
|
|
156
|
+
### Core Fabric Operations
|
|
157
|
+
|
|
158
|
+
| Tool Name | Description |
|
|
159
|
+
|-----------|-------------|
|
|
160
|
+
| `core_create-item` | Creates new Fabric items (Lakehouses, Notebooks, etc.). |
|
|
161
|
+
|
|
162
|
+
### Data Factory Operations
|
|
163
|
+
|
|
164
|
+
| Tool Name | Description |
|
|
165
|
+
|-----------|-------------|
|
|
166
|
+
| `datafactory_list-pipelines` | Lists all pipelines in a Microsoft Fabric workspace. |
|
|
167
|
+
| `datafactory_create-pipeline` | Creates a new pipeline in a workspace. |
|
|
168
|
+
| `datafactory_get-pipeline` | Gets details of a specific pipeline. |
|
|
169
|
+
| `datafactory_run-pipeline` | Runs a pipeline on demand. |
|
|
170
|
+
| `datafactory_list-dataflows` | Lists all Dataflow Gen2 items in a workspace. |
|
|
171
|
+
| `datafactory_create-dataflow` | Creates a new Dataflow Gen2 item. |
|
|
172
|
+
| `datafactory_execute-query` | Executes an M (Power Query) query against a dataflow. |
|
|
121
173
|
|
|
122
174
|
> Always verify available commands via `--help`. Command names and availability may change between releases.
|
|
123
175
|
|
|
124
|
-
## OneLake (`onelake`)
|
|
125
|
-
|
|
126
|
-
| Command | Purpose |
|
|
127
|
-
|---|---|
|
|
128
|
-
| `onelake download file` | Download a OneLake file to disk. |
|
|
129
|
-
| `onelake upload file` | Upload a local file into OneLake. |
|
|
130
|
-
| `onelake directory create` | Create a directory via the DFS endpoint. |
|
|
131
|
-
| `onelake directory delete` | Delete a directory (optionally recursive). |
|
|
132
|
-
| `onelake file list` | List files using the hierarchical file-list endpoint. |
|
|
133
|
-
| `onelake file delete` | Remove individual files from OneLake storage. |
|
|
134
|
-
| `onelake item list` | List workspace items and high-level metadata. |
|
|
135
|
-
| `onelake item list-data` | List Fabric items via the DFS endpoint. |
|
|
136
|
-
| `onelake item create` | Provision new Fabric items (lakehouse, notebook, etc.). |
|
|
137
|
-
| `onelake table config get` | Retrieve table API configuration for a workspace item. |
|
|
138
|
-
| `onelake table namespace list` | Enumerate table namespaces (schemas) exposed through the table API. |
|
|
139
|
-
| `onelake table namespace get` | Inspect metadata for a specific namespace. |
|
|
140
|
-
| `onelake table list` | List tables published within a namespace. |
|
|
141
|
-
| `onelake table get` | Retrieve the definition for a specific table. |
|
|
142
|
-
|
|
143
|
-
All commands accept either GUID identifiers (`--workspace-id`, `--item-id`) or friendly names (`--workspace`, `--item`), with the exception of `onelake item create`, which currently requires GUID identifiers. Friendly-name items must be provided as `<itemName>.<itemType>` (for example, `SalesLakehouse.lakehouse`). Table commands also accept the schema via `--namespace` or its alias `--schema`. Use `dotnet run -- onelake --help` (or `fabmcp onelake --help` for published builds) to inspect the complete option set before scripting.
|
|
144
|
-
|
|
145
176
|
# Support and Reference
|
|
146
177
|
|
|
147
178
|
## Documentation
|
|
@@ -151,10 +182,10 @@ All commands accept either GUID identifiers (`--workspace-id`, `--item-id`) or f
|
|
|
151
182
|
|
|
152
183
|
## Feedback and Support
|
|
153
184
|
|
|
154
|
-
-
|
|
185
|
+
- 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.
|
|
155
186
|
- Check the [Troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/TROUBLESHOOTING.md) to diagnose and resolve common issues.
|
|
156
187
|
- We're building this in the open. Your feedback is much appreciated!
|
|
157
|
-
-
|
|
188
|
+
- [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we'd love to hear from you!
|
|
158
189
|
|
|
159
190
|
## Security
|
|
160
191
|
|
|
@@ -172,10 +203,10 @@ We welcome contributions to the Fabric MCP Server! Whether you're fixing bugs, a
|
|
|
172
203
|
|
|
173
204
|
Please read our [Contributing Guide](https://github.com/microsoft/mcp/blob/main/CONTRIBUTING.md) for guidelines on:
|
|
174
205
|
|
|
175
|
-
*
|
|
176
|
-
*
|
|
177
|
-
*
|
|
178
|
-
*
|
|
206
|
+
* Setting up your development environment
|
|
207
|
+
* Adding new commands
|
|
208
|
+
* Code style and testing requirements
|
|
209
|
+
* Making pull requests
|
|
179
210
|
|
|
180
211
|
## Code of Conduct
|
|
181
212
|
This project has adopted the
|
package/dist/fabmcp
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@microsoft/fabric-mcp-linux-x64",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Microsoft Fabric MCP Server - Model Context Protocol implementation for Fabric, for linux on x64",
|
|
5
5
|
"author": "Microsoft",
|
|
6
6
|
"homepage": "https://github.com/Microsoft/mcp/blob/main/servers/Fabric.Mcp.Server#readme",
|