Kom i gang med Fabric MCP Server (lokal)

Installer den lokale Fabric MCP Server og brug AI-agenter til at arbejde med Fabric API'er, OneLake-data og artikeldefinitioner fra din udviklingsmaskine.

Bemærkning

Fabric MCP Server er et open source-projekt på GitHub. Denne quickstart dækker det væsentlige — GitHub-arkivet indeholder detaljerede opsætningsinstruktioner og fejlfinding.

Forudsætninger

Før du installerer Fabric MCP Server, skal du sikre dig, at du har:

  • En MCP-kompatibel AI-agent — VS kode med GitHub Copilot (anbefalet) eller enhver MCP-vært, der understøtter stdio-transport

Yderligere forudsætninger afhænger af din installationsmetode:

Metode Forudsætning
VS Code-udvidelse Ingen
NPM/NPX Node.js 20 LTS eller senere (download)
Kildeopbygning .NET 9 SDK eller senere (download)

Installér

Virker med både Stable og Insiders builds af VS Code.

  1. Installer GitHub Copilot Chat-udvidelsen.
  2. Installer Fabric MCP Server-udvidelsen.

Du behøver ikke yderligere konfiguration. Udvidelsen registrerer automatisk MCP-serveren.

Mulighed 2: npm/npx (enhver MCP-klient)

Kræver Node.js 20 LTS eller senere. Verificér med node --version.

Tilføj følgende til din klients mcp.json fil:

{
    "mcpServers": {
        "fabric-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@microsoft/fabric-mcp@latest",
                "server",
                "start",
                "--mode",
                "all"
            ]
        }
    }
}

Mulighed 3: Byg fra kildekode (.NET)

Kræver .NET 9 SDK eller nyere. Verificér med dotnet --version.

git clone https://github.com/microsoft/mcp.git
cd mcp
dotnet build servers/Fabric.Mcp.Server/src/Fabric.Mcp.Server.csproj --configuration Release

Tilføj derefter følgende til din klients mcp.json fil:

{
    "mcpServers": {
        "Fabric MCP Server": {
            "command": "/path/to/repo/servers/Fabric.Mcp.Server/src/bin/Release/fabmcp",
            "args": [
                "server",
                "start"
            ],
            "type": "stdio"
        }
    }
}

Bemærkning

På Windows brug bagskråstreger og tilføj .exe-udvidelsen: C:\path\to\repo\servers\Fabric.Mcp.Server\src\bin\Release\fabmcp.exe

Bemærkning

Når du konfigurerer Visual Studio eller Visual Studio Code manuelt, brug servers i stedet for mcpServers som root-JSON-nøgle.

Klientspecifik konfiguration

Hvis du ikke har brugt VS Code-udvidelsen, så placer din mcp.json konfiguration på den placering, som din MCP-vært kræver:

Klient Filplacering Dokumentation
VS Code .vscode/mcp.json (arbejdsområde) eller settings.json (bruger) VS Code MCP-dokumentation
Andre værter Se din værts dokumentation for MCP-serverens konfigurationsfilplacering

Bekræft din installation

  1. Åbn GitHub Copilot i VS Code og skift til Agent-tilstand.

  2. Vælg opdater på værktøjslisten. Du burde kunne se Fabric MCP Server-værktøjerne listet.

  3. Prøv en prompt, der bruger Fabric-kontekst:

    What Fabric workload types are available?
    

Hvis agenten returnerer en liste over Fabric-arbejdsbelastningstyper, fungerer din server korrekt.

Eksempler på prompter

Efter installationen kan du prøve disse prompts for at udforske, hvad serveren kan:

Scenarie Eksempelprompt
Gennemse API-specifikationer "Vis mig OpenAPI-handlingerne for 'notesbog', og giv et eksempel på oprettelse af brødtekst"
Udforsk itemskemaer "Vis JSON-skemaet for en datapipelineelementdefinition"
Få bedste praksis "Vis de bedste fremgangsmåder til håndtering af API-begrænsning i Fabric"
Listearbejdsområder "List mine Fabric-arbejdsområder"
Arbejd med filer "Download config.json-filen fra mit salgshus ved søen"
Opret elementer "Opret et nyt Lakehouse kaldet CustomerData i mit udviklingsområde"

For en komplet liste over værktøjer og eksempler på flertrins arbejdsgange, se værktøjsreferencen.

Næste trin