MCP Resourcelinks

🚀 數據verse MCP服務器 - 高級MCP功能展示

本倉庫展示了一個複雜的 模型上下文協議（MCP）服務器，該服務器與微軟數據verse集成，展示了超越基本工具執行的高級MCP功能。其特性包括通過 Chart.js 報告生成實現智能數據可視化。

✨ 主要特性

🔄 MCP 啟發

服務器會提示用戶選擇接收原始 JSON 數據還是將結果保存為格式化資源。

🧠 MCP 採樣

通過內部調用大語言模型（LLM）進行 採樣 來進行數據轉換，將原始數據verse的 JSON 響應轉換為用戶友好的格式，包括 Markdown 表格和交互式 Chart.js 可視化。

📁 MCP 資源

動態資源創建，將轉換後的數據存儲為可從 MCP 服務器訪問的資源。支持 Markdown 文檔和可在瀏覽器中查看的交互式 HTML 報告。

📊 MCP 進度

在批量操作（例如，創建多個聯繫人記錄、生成報告）期間提供即時進度通知，包括狀態更新和完成跟蹤。

🚀 快速開始

1. 克隆倉庫
2. 將 appsettings.json 複製到 appsettings.local.json 並配置數據verse 憑證
3. 運行：dotnet run --project MyDataverseMcpServer --environment Development
4. 服務器運行在 http://localhost:3001

🔧 技術細節

本項目基於以下技術構建：

• ASP.NET Core 和 .NET 9.0
• C# MCP SDK 用於協議實現
• Microsoft.PowerPlatform.Dataverse.Client 用於數據verse 集成
• ModelContextProtocol.AspNetCore v0.3.0-preview.3
• Chart.js 用於通過基於模板的生成實現交互式數據可視化

💻 使用示例

數據檢索與資源創建

1. 查詢執行：使用 ExecuteFetch 工具對數據verse 執行 FetchXML 查詢
2. 智能結果處理：MCP 啟發提示用戶將結果保存為資源
3. 數據轉換：MCP 採樣將 JSON 轉換為 Markdown 表格
4. 資源創建：將格式化數據保存為帶有描述性元數據的 MCP 資源

報告生成

1. 數據輸入：通過 CreateReportFromQuery 或 CreateReportFromData 提供 FetchXML 查詢或 CSV 數據
2. 圖表生成：MCP 採樣根據數據和報告要求生成 Chart.js 代碼
3. 模板處理：將大語言模型生成的代碼插入帶有自定義標題的 HTML 模板
4. HTTP 服務：可在 http://localhost:3001/dynamic/{filename}.html 訪問交互式報告

📦 可用的 MCP 工具

數據操作

• ExecuteFetch：執行 FetchXML 查詢並進行智能結果處理
• WhoAmI：數據verse 身份驗證
• BulkCreateRandomContacts：批量創建數據並跟蹤進度

報告生成

• CreateReportFromQuery：根據 FetchXML 查詢生成 Chart.js 可視化
• CreateReportFromData：根據 CSV 數據創建帶有自定義標題的 Chart.js 報告

資源管理

• CreateTextResource：為任何文本內容創建基本資源

🎥 演示

這個 視頻 展示瞭如何使用此 MCP 服務器在 VS Code 中：

• 通過 FetchXML 查詢檢索數據verse 數據
• 將大型結果集轉換為 Markdown 格式的資源
• 可選擇將資源添加到 AI 上下文窗口以增強對話

這個 視頻 展示了報告生成功能：

• 通過 FetchXML 查詢檢索數據verse 數據並將其作為 MCP 資源提供。
• 使用自然語言將結果轉換為 Chart.js 可視化。