Skip to content

Commit 49731d8

Browse files
authored
Fabric MCP - Prepare for 1.0.0 GA release (#2389)
* Fabric MCP - Prepare for 1.0.0 GA release * Fix changelog and update release date
1 parent cc4ef95 commit 49731d8

File tree

6 files changed

+155
-14
lines changed

6 files changed

+155
-14
lines changed

servers/Fabric.Mcp.Server/CHANGELOG.md

Lines changed: 46 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,60 @@ All notable changes to the Microsoft Fabric MCP Server will be documented in thi
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8-
## 0.0.0-beta.11 (Unreleased)
8+
## 1.0.0 (2026-04-14)
9+
10+
**First Stable Release**
11+
12+
We're excited to announce the first stable release of the Microsoft Fabric MCP Server! After months of development across 10 beta releases, extensive testing, and valuable community feedback, the Fabric MCP Server is now generally available. It provides AI agents with comprehensive context about Microsoft Fabric through the Model Context Protocol (MCP) specification — enabling intelligent code generation, API guidance, and data platform operations.
13+
14+
### What's Included in 1.0.0
15+
16+
The Microsoft Fabric MCP Server now offers:
17+
18+
- **Complete Fabric API Context**: Full OpenAPI specifications for all supported Fabric workloads including Lakehouse, Warehouse, KQL Database, Eventhouse, Data Pipeline, Dataflow, Notebook, Report, Semantic Model, and many more
19+
- **OneLake Data Operations**: Full support for OneLake file and directory operations, item management, workspace listing, and table metadata retrieval
20+
- **Item Definition Knowledge**: JSON schemas for every Fabric item type — enabling AI agents to generate correct item definitions out of the box
21+
- **Built-in Best Practices**: Embedded guidance for pagination, long-running operations, error handling, retry logic, API throttling, and authentication patterns
22+
- **Multiple Installation Methods**: Available through NuGet, npm, and Docker
23+
- **Flexible Server Modes**: Namespace mode, consolidated mode, single mode, and all mode for different tool organization preferences
24+
- **Production Ready**: Comprehensive error handling, telemetry, caching controls, and extensive test coverage
25+
- **Local-First Security**: Runs entirely on your machine with optional remote HTTP deployment for shared scenarios
26+
27+
### Key Features
28+
29+
- **OneLake Tools**: File read/write/delete/list, directory create/delete, item create/list, workspace list, table config/namespace/metadata retrieval
30+
- **Public API Tools**: Workload API specifications, best practices, item definitions, platform APIs, and example request/response files
31+
- **Enterprise Support**: Proxy configuration, managed identity authentication, on-behalf-of flow for multi-user remote scenarios, and caching controls
32+
- **Performance**: Selective caching for expensive operations, `--disable-caching` option for real-time data needs
33+
34+
### Getting Started
35+
36+
Install the Microsoft Fabric MCP Server from your preferred platform:
37+
38+
- **NuGet**: `dotnet tool install -g Microsoft.Fabric.Mcp --version 1.0.0`
39+
- **npm**: `npx @microsoft/fabric-mcp@1.0.0`
40+
- **Docker**: `docker pull mcr.microsoft.com/fabric/fabric-mcp:1.0.0`
41+
42+
### Thank You
43+
44+
This release wouldn't have been possible without the contributions from our community, extensive testing from early adopters, and collaboration across the MCP ecosystem. Thank you for your feedback, bug reports, and feature requests that helped shape this stable release.
45+
46+
For a complete history of pre-release changes, see versions [0.0.0-beta.10](#000-beta10-2026-03-24) through [0.0.0-beta.2](#000-beta2-2025-11-21) below.
947

1048
### Features Added
1149

12-
### Breaking Changes
50+
- Add `--disable-caching` to server start options to disable caching. [[#2330](https://github.com/microsoft/mcp/pull/2330)]
1351

1452
### Bugs Fixed
1553

54+
- Update HttpRequestException to attempt to return a more specific status code for better troubleshooting. [[#2172](https://github.com/microsoft/mcp/pull/2172)]
55+
1656
### Other Changes
1757

58+
#### Dependency Updates
59+
60+
- Updated ModelContextProtocol and ModelContextProtocol.AspNetCore dependencies to version 1.1.0. [[#1963](https://github.com/microsoft/mcp/pull/1963)]
61+
1862
## 0.0.0-beta.10 (2026-03-24)
1963

2064
### Features Added

servers/Fabric.Mcp.Server/changelog-entries/1774379067978.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

servers/Fabric.Mcp.Server/changelog-entries/1774651569770.yaml

Lines changed: 0 additions & 4 deletions
This file was deleted.

servers/Fabric.Mcp.Server/changelog-entries/1775162068769.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

servers/Fabric.Mcp.Server/src/Fabric.Mcp.Server.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<Project Sdk="Microsoft.NET.Sdk">
22
<PropertyGroup>
3-
<Version>0.0.0-beta.11</Version>
3+
<Version>1.0.0</Version>
44
<CliName>fabmcp</CliName>
55
<AssemblyTitle>Fabric MCP Server</AssemblyTitle>
66
<Description>Microsoft Fabric MCP Server - Model Context Protocol implementation for Fabric</Description>
Lines changed: 108 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,111 @@
11
# Release History
22

3+
## 1.0.0 (2026-04-14)
4+
5+
**First Stable Release**
6+
7+
We're excited to announce the first stable release of the Microsoft Fabric MCP Server VS Code extension! The Fabric MCP Server is now generally available, providing AI agents with comprehensive context about Microsoft Fabric through the Model Context Protocol (MCP).
8+
9+
### Added
10+
11+
- Add `--disable-caching` to server start options to disable caching. [[#2330](https://github.com/microsoft/mcp/pull/2330)]
12+
13+
### Changed
14+
15+
- Updated `ModelContextProtocol` and `ModelContextProtocol.AspNetCore` dependencies to version 1.1.0. [[#1963](https://github.com/microsoft/mcp/pull/1963)]
16+
17+
### Fixed
18+
19+
- Updated `HttpRequestException` handling to return more specific HTTP status codes for better troubleshooting. [[#2172](https://github.com/microsoft/mcp/pull/2172)]
20+
21+
## 0.0.0-beta.10 (2026-03-24) (pre-release)
22+
23+
### Changed
24+
25+
- **Breaking:** Changed Fabric tool names to use dash instead of underscore. `create-item`, `api-examples`, `best-practices`, `item-definitions`, `platform-api-spec`, and `workload-api-spec` have dashes now.
26+
- Reintroduced capturing error information in telemetry with standard `exception.message`, `exception.type`, and `exception.stacktrace` telemetry tags, replacing `ErrorDetails` tag.
27+
- Updated Fabric REST API specifications and examples. Updated item definition documentation.
28+
29+
### Fixed
30+
31+
- Added filtering on `LocalRequired` when running in remote mode.
32+
- Fixed directory traversal vulnerability in OneLake file operations. Paths containing `..` sequences are now rejected before any HTTP request is made.
33+
34+
## 0.0.0-beta.9 (2026-03-03) (pre-release)
35+
336
### Added
4-
- Initial Release
37+
38+
- Added OneLake table API commands for configuration, namespace management, and table metadata retrieval:
39+
- `onelake table config get`
40+
- `onelake table namespace list`
41+
- `onelake table namespace get`
42+
- `onelake table list`
43+
- `onelake table get`
44+
45+
## 0.0.0-beta.8 (2026-02-10) (pre-release)
46+
47+
_No user-facing changes._
48+
49+
## 0.0.0-beta.7 (2026-02-09) (pre-release)
50+
51+
### Changed
52+
53+
- Updated Fabric REST API specifications and examples.
54+
- Updated item definition documentation.
55+
56+
## 0.0.0-beta.6 (2026-01-22) (pre-release)
57+
58+
### Changed
59+
60+
- Updated Microsoft Fabric REST API specifications with new connection credential features: KeyPair credential type with identifier/private key support, Key Vault secret references for Basic/Key/ServicePrincipal/SharedAccessSignature credentials, SQL endpoint `recreateTables` option for metadata refresh, updated connection examples, and corrected rate limiting documentation for tags APIs.
61+
62+
## 0.0.0-beta.5 (2026-01-05) (pre-release)
63+
64+
### Added
65+
66+
- Added comprehensive API throttling best practices guide with production-ready retry patterns, exponential backoff, circuit breakers, and code examples in C#, Python, and TypeScript.
67+
- Added Admin APIs usage guidelines to help LLMs understand when to use admin APIs, request explicit user permission, and implement graceful fallbacks to standard APIs.
68+
69+
### Changed
70+
71+
- Updated Fabric REST API specifications and examples.
72+
73+
## 0.0.0-beta.4 (2025-12-16) (pre-release)
74+
75+
### Added
76+
77+
- **OneLake Toolset**: Added comprehensive support for OneLake operations including file read/write/delete/list, directory create/delete, item create/list, workspace listing, and multi-environment support. [[#1113](https://github.com/microsoft/mcp/pull/1113)]
78+
- **Public APIs Toolset**: Added API specifications for Cosmos DB Database, Operations Agent, Graph Model, and Snowflake Database. Updated API specifications for multiple items.
79+
80+
## 0.0.0-beta.3 (2025-12-04) (pre-release)
81+
82+
### Added
83+
84+
- Added Docker image release for Fabric MCP Server. [[#1241](https://github.com/microsoft/mcp/pull/1241)]
85+
- Added new item definitions for Lakehouse, Ontology, and Snowflake Database workloads. [[#1240](https://github.com/microsoft/mcp/pull/1240)]
86+
- Enhanced README documentation for released packages.
87+
88+
### Fixed
89+
90+
- Fixed UI for server help messages and display to show Fabric.Mcp.Server. [[#1269](https://github.com/microsoft/mcp/pull/1269)]
91+
92+
## 0.0.0-beta.2 (2025-11-21) (pre-release)
93+
94+
### Added
95+
96+
Initial release of the Microsoft Fabric MCP Server in **Public Preview**.
97+
98+
- **Complete API Context**: Full OpenAPI specifications for all supported Fabric workloads.
99+
- **Item Definition Knowledge**: JSON schemas for every Fabric item type including Lakehouse, Warehouse, KQL Database, Eventhouse, Data Pipeline, Dataflow, Notebook, Report, Semantic Model, and many more.
100+
- **Built-in Best Practices**: Embedded guidance for pagination, long-running operations, error handling, and authentication.
101+
- **Local-First Security**: Runs entirely on your machine without connecting to live Fabric environments.
102+
- **Platform APIs**: Core platform operations for workspace management and common resources.
103+
- **Example-Driven Development**: Real API request/response examples for every workload.
104+
105+
**Public API Tools**:
106+
- `publicapis bestpractices examples get` - Retrieve example API request/response files.
107+
- `publicapis bestpractices get` - Get embedded best practice documentation.
108+
- `publicapis bestpractices itemdefinition get` - Get JSON schema definitions for workload items.
109+
- `publicapis get` - Get workload-specific API specifications.
110+
- `publicapis list` - List all available Fabric workload types.
111+
- `publicapis platform get` - Get platform-level API specifications.

0 commit comments

Comments
 (0)