Aifoundry MCPConnector FabricGraphQL

🚀 集成 AI 代理與微軟 Fabric 數據倉庫的 MCP 連接器：使用模型上下文協議（MCP）

本項目展示瞭如何藉助模型上下文協議（MCP），將由 Azure OpenAI 支持的 AI 代理與 Microsoft Fabric 數據倉庫集成。MCP 是 Anthropic 開發的開放整合標準，它允許動態發現工具、數據資源和提示模板（後續還會推出更多功能），實現與 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. 安裝所需的 Python 包，如提供的 requirements.txt 所示：

   pip install -r requirements.txt
   

2. 配置 MCP 客戶端的環境變量：

3. 將變量 AZURE_FABRIC_GRAPHQL_ENDPOINT 的值設為第 1 步中的 GraphQL 端點 URL。它將被 MCP 服務器腳本用於連接到 Microsoft Fabric：

💻 使用示例

第 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 視頻 中找到。