@microsoft/fabric-mcp-darwin-x64 0.0.0-beta.9 → 1.0.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 +68 -51
- package/dist/fabmcp +0 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -5,17 +5,28 @@ 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)
|
|
12
22
|
- [Support and Reference](#support-and-reference)
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
23
|
+
- [Documentation](#documentation)
|
|
24
|
+
- [Feedback and Support](#feedback-and-support)
|
|
25
|
+
- [Security](#security)
|
|
26
|
+
- [Data Collection](#data-collection)
|
|
27
|
+
- [Contributing](#contributing)
|
|
28
|
+
- [Code of Conduct](#code-of-conduct)
|
|
29
|
+
- [License](#license)
|
|
19
30
|
|
|
20
31
|
# Overview
|
|
21
32
|
|
|
@@ -70,27 +81,27 @@ Key capabilities:
|
|
|
70
81
|
- The agent should be able to use the Fabric MCP Server tools to complete your query
|
|
71
82
|
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
83
|
1. We're building this in the open. Your feedback is much appreciated!
|
|
73
|
-
-
|
|
84
|
+
- [Open an issue in the public repository](https://github.com/microsoft/mcp/issues/new/choose)
|
|
74
85
|
|
|
75
86
|
## What can you do with the Fabric MCP Server?
|
|
76
87
|
|
|
77
|
-
|
|
88
|
+
The Fabric MCP Server supercharges your agents with Microsoft Fabric context. Here are some prompts you can try:
|
|
78
89
|
|
|
79
|
-
###
|
|
90
|
+
### Fabric Workloads & APIs
|
|
80
91
|
|
|
81
92
|
* "What are the available Fabric workload types I can work with?"
|
|
82
93
|
* "Show me the OpenAPI operations for 'notebook' and give a sample creation body"
|
|
83
94
|
* "Get the platform-level API specifications for Microsoft Fabric"
|
|
84
95
|
* "List all supported Fabric item types"
|
|
85
96
|
|
|
86
|
-
###
|
|
97
|
+
### Resource Definitions & Schemas
|
|
87
98
|
|
|
88
99
|
* "Create a Lakehouse resource definition with a schema that enforces a string column and a datetime column"
|
|
89
100
|
* "Show me the JSON schema for a Data Pipeline item definition"
|
|
90
101
|
* "Generate a Semantic Model configuration with sample measures"
|
|
91
102
|
* "What properties are required for creating a KQL Database?"
|
|
92
103
|
|
|
93
|
-
###
|
|
104
|
+
### Best Practices & Examples
|
|
94
105
|
|
|
95
106
|
* "Show me best practices for handling API throttling in Fabric"
|
|
96
107
|
* "How should I implement retry logic for Fabric API rate limits?"
|
|
@@ -99,7 +110,7 @@ Key capabilities:
|
|
|
99
110
|
* "Get example request/response payloads for creating a Notebook"
|
|
100
111
|
* "What are the pagination patterns for Fabric REST APIs?"
|
|
101
112
|
|
|
102
|
-
###
|
|
113
|
+
### Development Workflows
|
|
103
114
|
|
|
104
115
|
* "Generate a data pipeline configuration with sample data sources"
|
|
105
116
|
* "Help me scaffold a Fabric workspace with Lakehouse and notebooks"
|
|
@@ -108,40 +119,46 @@ Key capabilities:
|
|
|
108
119
|
|
|
109
120
|
## Available Tools
|
|
110
121
|
|
|
111
|
-
The Fabric MCP Server exposes
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
|
116
|
-
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
122
|
+
The Fabric MCP Server exposes tools organized into three categories:
|
|
123
|
+
|
|
124
|
+
### API Documentation & Best Practices
|
|
125
|
+
|
|
126
|
+
| Tool Name | Description |
|
|
127
|
+
|-----------|-------------|
|
|
128
|
+
| `docs_workloads` | Lists Fabric workload types that have public API specifications available. |
|
|
129
|
+
| `docs_workload-api-spec` | Retrieves the complete OpenAPI specification for a specific Fabric workload. |
|
|
130
|
+
| `docs_platform-api-spec` | Retrieves the OpenAPI specification for core Fabric platform APIs. |
|
|
131
|
+
| `docs_item-definitions` | Retrieves JSON schema definitions for items in a Fabric workload API. |
|
|
132
|
+
| `docs_best-practices` | Retrieves best practice documentation and guidance for a specific topic. |
|
|
133
|
+
| `docs_api-examples` | Retrieves example API request/response files for a specific workload. |
|
|
134
|
+
|
|
135
|
+
### OneLake Data Operations
|
|
136
|
+
|
|
137
|
+
| Tool Name | Description |
|
|
138
|
+
|-----------|-------------|
|
|
139
|
+
| `onelake_list_workspaces` | Lists available Microsoft Fabric workspaces. |
|
|
140
|
+
| `onelake_list_items` | Lists workspace items with high-level metadata. |
|
|
141
|
+
| `onelake_list_items_dfs` | Lists Fabric items via the DFS endpoint. |
|
|
142
|
+
| `onelake_list_files` | Lists files using the hierarchical file-list endpoint. |
|
|
143
|
+
| `onelake_download_file` | Downloads a OneLake file. |
|
|
144
|
+
| `onelake_upload_file` | Uploads a file to OneLake storage. |
|
|
145
|
+
| `onelake_delete_file` | Deletes a file from OneLake storage. |
|
|
146
|
+
| `onelake_create_directory` | Creates a directory via the DFS endpoint. |
|
|
147
|
+
| `onelake_delete_directory` | Deletes a directory (optionally recursive). |
|
|
148
|
+
| `onelake_get_table_config` | Retrieves table API configuration for a workspace item. |
|
|
149
|
+
| `onelake_list_table_namespaces` | Lists table namespaces (schemas) exposed through the table API. |
|
|
150
|
+
| `onelake_get_table_namespace` | Retrieves metadata for a specific namespace. |
|
|
151
|
+
| `onelake_list_tables` | Lists tables published within a namespace. |
|
|
152
|
+
| `onelake_get_table` | Retrieves the definition for a specific table. |
|
|
153
|
+
|
|
154
|
+
### Core Fabric Operations
|
|
155
|
+
|
|
156
|
+
| Tool Name | Description |
|
|
157
|
+
|-----------|-------------|
|
|
158
|
+
| `core_create-item` | Creates new Fabric items (Lakehouses, Notebooks, etc.). |
|
|
121
159
|
|
|
122
160
|
> Always verify available commands via `--help`. Command names and availability may change between releases.
|
|
123
161
|
|
|
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
162
|
# Support and Reference
|
|
146
163
|
|
|
147
164
|
## Documentation
|
|
@@ -154,7 +171,7 @@ All commands accept either GUID identifiers (`--workspace-id`, `--item-id`) or f
|
|
|
154
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.
|
|
155
172
|
- Check the [Troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Fabric.Mcp.Server/TROUBLESHOOTING.md) to diagnose and resolve common issues.
|
|
156
173
|
- We're building this in the open. Your feedback is much appreciated!
|
|
157
|
-
-
|
|
174
|
+
- [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we'd love to hear from you!
|
|
158
175
|
|
|
159
176
|
## Security
|
|
160
177
|
|
|
@@ -172,10 +189,10 @@ We welcome contributions to the Fabric MCP Server! Whether you're fixing bugs, a
|
|
|
172
189
|
|
|
173
190
|
Please read our [Contributing Guide](https://github.com/microsoft/mcp/blob/main/CONTRIBUTING.md) for guidelines on:
|
|
174
191
|
|
|
175
|
-
*
|
|
176
|
-
*
|
|
177
|
-
*
|
|
178
|
-
*
|
|
192
|
+
* Setting up your development environment
|
|
193
|
+
* Adding new commands
|
|
194
|
+
* Code style and testing requirements
|
|
195
|
+
* Making pull requests
|
|
179
196
|
|
|
180
197
|
## Code of Conduct
|
|
181
198
|
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-darwin-x64",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.0.0",
|
|
4
4
|
"description": "Microsoft Fabric MCP Server - Model Context Protocol implementation for Fabric, for darwin on x64",
|
|
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
|
-
"
|
|
18
|
-
"
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "https://github.com/microsoft/mcp.git"
|
|
19
19
|
},
|
|
20
20
|
"engines": {
|
|
21
21
|
"node": ">=20.0.0"
|