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 可视化。