@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.
Files changed (3) hide show
  1. package/README.md +68 -51
  2. package/dist/fabmcp +0 -0
  3. 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
- - [Getting Started](#getting-started)
10
- - [What can you do with the Fabric MCP Server?](#what-can-you-do-with-the-fabric-mcp-server)
11
- - [Available Tools](#available-tools)
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
- - [Documentation](#documentation)
14
- - [Feedback and Support](#feedback-and-support)
15
- - [Security](#security)
16
- - [Data Collection](#data-collection)
17
- - [Contributing](#contributing)
18
- - [Code of Conduct](#code-of-conduct)
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
- - 👉 [Open an issue in the public repository](https://github.com/microsoft/mcp/issues/new/choose)
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
- The Fabric MCP Server supercharges your agents with Microsoft Fabric context. Here are some prompts you can try:
88
+ The Fabric MCP Server supercharges your agents with Microsoft Fabric context. Here are some prompts you can try:
78
89
 
79
- ### 📊 Fabric Workloads & APIs
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
- ### 🏗️ Resource Definitions & Schemas
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
- ### 📝 Best Practices & Examples
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
- ### 🔧 Development Workflows
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 the following tools for AI agents:
112
-
113
- | Tool | Tool Name | Description |
114
- |------|-----------|-------------|
115
- | List Public APIs | `publicapis_list` | List all Microsoft Fabric workload types that have public API specifications available |
116
- | Get Public API | `publicapis_get` | Retrieve the complete OpenAPI/Swagger specification for a specific Microsoft Fabric workload |
117
- | Get Platform API | `publicapis_platform_get` | Retrieve the OpenAPI/Swagger specification for Microsoft Fabric platform APIs |
118
- | Get Best Practices | `publicapis_bestpractices_get` | Retrieve embedded best practice documentation and guidance for a specific Microsoft Fabric topic |
119
- | Get Best Practices Examples | `publicapis_bestpractices_examples_get` | Retrieve all example API request/response files for a specific Microsoft Fabric workload |
120
- | Get Item Definition | `publicapis_bestpractices_itemdefinition_get` | Retrieve the JSON schema definitions for specific items within a Microsoft Fabric workload's API |
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
- - 👉 [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we'd love to hear from you!
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
- * 🛠️ Setting up your development environment
176
- * Adding new commands
177
- * 📝 Code style and testing requirements
178
- * 🔄 Making pull requests
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": "0.0.0-beta.9",
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
- "url": "https://github.com/microsoft/mcp.git",
18
- "type": "git"
17
+ "type": "git",
18
+ "url": "https://github.com/microsoft/mcp.git"
19
19
  },
20
20
  "engines": {
21
21
  "node": ">=20.0.0"