fabric -claude-extension

This MCP server powers the Claude Desktop extension for Microsoft Fabric by exposing a local MCP endpoint that Claude can query to obtain Fabric API documentation, item definitions, and embedded best practices. After installation, Claude can call the three primary tools to explore Fabric capabilities: platform_get_platform_apis (detailed endpoints, operations, and schemas for Fabric platform APIs), platform_get_item_definitions (JSON schemas for Fabric item types like Lakehouses, pipelines, semantic models, notebooks, etc.), and platform_get_best_practices (guided patterns for common tasks such as pagination, error handling, and recommended usage). Use these tools to gather authoritative metadata and schemas to assist in code generation and API exploration without accessing real Fabric environments.

Typical workflows include asking Claude to list available Fabric Lakehouse APIs, retrieve a JSON schema for creating a pipeline, or fetch embedded best practices for handling API pagination. The extension is designed for local-first use, so you can query capabilities and generate code samples offline, then adapt them to your Fabric deployment when you’re ready to connect to actual environments.

Prerequisites:

• .NET 8.0 (or later) SDK
• Git
• PowerShell 7+ (Windows) or Bash (macOS/Linux)

Install steps (Build from Source):

1. Clone the repository or the extension template: git clone <repository-url> cd fabric-mcp-extension

2. Build the extension:

   • Windows (PowerShell): ./scripts/Build-FabricMcpExtension.ps1
   • macOS/Linux (Bash): ./scripts/build.sh

   The build process creates a .mcpb bundle suitable for Claude Desktop.

3. Install the extension in Claude Desktop:

   • Open Claude Desktop
   • Go to Settings > Extensions
   • Click "Install Extension..." and select the produced .mcpb file
   • The extension becomes available immediately

4. Verify the server runs locally by starting Claude and ensuring the extension appears under Extensions and is enabled.

Tips and common considerations:

• This MCP server is local-first and offline by design; it provides API docs and item schemas without connecting to any live Fabric environment.
• If you upgrade .NET or related tooling, rebuild the extension to ensure compatibility.
• The three main tools (platform_get_platform_apis, platform_get_item_definitions, platform_get_best_practices) can be queried via Claude’s command palette or chat prompts.
• If you encounter issues with installation, verify you’re using Claude Desktop v0.10.0 or newer, re-download the .mcpb file if corrupted, and ensure sufficient disk space.
• Environment variables like FABRIC_API_BASE_URL can be used to point to a mock or placeholder base URL if needed for local testing; these do not connect to real Fabric environments by default.