Aifoundry MCPConnector FabricGraphQL

🚀 モデルコンテキストプロトコル (MCP) を使用した、AI エージェントと Microsoft Fabric データウェアハウスの統合 MCP コネクタ

このリポジトリでは、Azure OpenAI をバックエンドとする AI エージェントを、Anthropic が開発したオープンな統合標準であるモデルコンテキストプロトコル (MCP) を使用して、Microsoft Fabric データウェアハウスに統合する方法を紹介します。

MCP を使用すると、ツール、データリソース、およびプロンプトテンプレート（今後さらに機能が追加予定）を動的に検出し、AI エージェントとの統合を一元化できます。GraphQL は、企業データへの双方向アクセスのための抽象層を提供します。以下では、MCP と GraphQL を組み合わせて、AI エージェントが企業データにアクセスできるようにする方法を詳しく説明します。

⚠️ 重要提示

MCP サーバースクリプトでは、一部のクエリパラメータ値がこの例ではハードコードされています。実際のシナリオでは、これらの値は動的に生成または取得する必要があります。

📚 目次

• 第 1 部：Microsoft Fabric バックエンドの設定
• 第 2 部：ローカルクライアント環境の設定
• 第 3 部：ユーザー体験 - Gradio UI
• 第 4 部：YouTube のデモビデオ

🚀 第 1 部：Microsoft Fabric バックエンドの設定

1. Microsoft Fabric で、新しいデータウェアハウスを作成し、サンプルデータで事前に埋める：
2. 次に、GraphQL API エンドポイントを作成する：
3. GraphQL API のデータ構成で、Trip (dbo.Trip) テーブルを選択する：
4. GraphQL API エンドポイントの URL をコピーする：

📦 第 2 部：ローカルクライアント環境の設定

1. 提供されている requirements.txt の通りに、必要な Python パッケージをインストールする：

   pip install -r requirements.txt
   

2. MCP クライアントの環境変数を設定する：

3. 変数 AZURE_FABRIC_GRAPHQL_ENDPOINT の値を、第 1 部で取得した GraphQL エンドポイントの URL に設定する。これは、MCP サーバースクリプトが Microsoft Fabric に接続するために使用されます： | 変数 | 説明 | | ------------------------------- | ------------------------------------| | AZURE_FABRIC_GRAPHQL_ENDPOINT | Microsoft Fabric の GraphQL API エンドポイント |

💻 第 3 部：ユーザー体験 - Gradio UI

1. コマンドプロンプトで MCP クライアントを起動する：

   python MCP_Client_Gradio.py
   

2. Initialise System ボタンをクリックして、MCP サーバーを起動し、AI エージェントを Microsoft Fabric の GraphQL API エンドポイントに接続する：
3. これで、GraphQL の クエリ と ミューテーション を使用して、この MCP コネクタを介してデータウェアハウスにデータを取得および送信できます：

🎥 第 4 部：YouTube のデモビデオ

この MCP コネクタの実用的なデモは、この YouTube ビデオ で見ることができます。