Fabric MCP サーバー (ローカル) の開始方法

ローカル Fabric MCP Server をインストールし、AI エージェントを使用して、開発用コンピューターからFabric API、OneLake データ、および項目定義を操作します。

Fabric MCP Server は、GitHub上のオープンソース プロジェクトです。 このクイックスタートでは、GitHub リポジトリに関する詳細なセットアップ手順とトラブルシューティングについて説明します。

前提条件

MCP サーバー Fabricインストールする前に、次の内容を確認してください。

  • MCP 互換 AI エージェント — GitHub Copilot (推奨) または stdio トランスポートをサポートする任意の MCP ホストを含む VS Code

追加の前提条件は、インストール方法によって異なります。

Method 前提条件
VS Code 拡張機能 None
npm/npx Node.js 20 LTS 以降 (ダウンロード)
ソース ビルド .NET 9 SDK 以降 (ダウンロード)

インストール

VS Code の 安定ビルドInsider ビルドの両方で動作します。

  1. GitHub Copilot Chat 拡張機能をインストールします。
  2. Fabric MCP Server 拡張機能をインストールします。

それ以上の構成は必要ありません。 拡張機能によって MCP サーバーが自動的に登録されます。

オプション 2: npm/npx (任意の MCP クライアント)

20 LTS 以降 Node.js 必要です。 node --version で確認します。

クライアントの mcp.json ファイルに次のコードを追加します。

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

オプション 3: ソースからビルドする (.NET)

.NET 9 SDK 以降が必要です。 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

次に、クライアントの mcp.json ファイルに次のコードを追加します。

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

Windowsで円記号を使用し、.exe 拡張子を追加します: C:\path\to\repo\servers\Fabric.Mcp.Server\src\bin\Release\fabmcp.exe

Visual StudioまたはVisual Studio Codeを手動で構成する場合は、ルート JSON キーとして servers ではなく、mcpServers を使用します。

クライアント固有の構成

VS Code 拡張機能を使用していない場合は、MCP ホストに必要な場所に mcp.json 構成を配置します。

Client ファイルの場所 ドキュメント
VS Code .vscode/mcp.json (ワークスペース) または settings.json (ユーザー) VS Code MCP のドキュメント
その他のホスト MCP サーバー構成ファイルの場所については、ホストのドキュメントを参照してください

インストールの検証

  1. VS CodeAgent モードに切り替えます。

  2. ツールの一覧で [更新 ] を選択します。 Fabric MCP サーバー ツールが一覧表示されます。

  3. Fabricコンテキストを使用するプロンプトを試してください。

    What Fabric workload types are available?
    

エージェントからワークロードの種類の一覧Fabric返された場合、サーバーは正常に動作しています。

プロンプトの例

インストール後、次のプロンプトを試して、サーバーで実行できる操作を調べてみてください。

Scenario プロンプトの例
API 仕様を参照する "'notebook' の OpenAPI 操作を表示し、サンプル作成本文を指定する"
項目スキーマを調べる "データ パイプライン項目定義の JSON スキーマを表示する"
ベスト プラクティスを取得する Fabric での API スロットリングを処理するためのベストプラクティスを紹介する
ワークスペースを一覧表示する "Fabric ワークスペースを一覧表示する"
ファイルの操作 "sales lakehouse から config.json ファイルをダウンロードする"
アイテムの作成 "開発ワークスペースに CustomerData という名前の新しい Lakehouse を作成する"

ツールとマルチステップ ワークフローの例の完全な一覧については、ツール リファレンスを 参照してください。

次のステップ