🚀 数据verse MCP服务器 - 高级MCP功能展示
本仓库展示了一个复杂的 模型上下文协议（MCP）服务器，该服务器与微软数据verse集成，展示了超越基本工具执行的高级MCP功能。其特性包括通过 Chart.js 报告生成实现智能数据可视化。
✨ 主要特性
🔄 MCP 启发
服务器会提示用户选择接收原始 JSON 数据还是将结果保存为格式化资源。
🧠 MCP 采样
通过内部调用大语言模型（LLM）进行 采样 来进行数据转换，将原始数据verse的 JSON 响应转换为用户友好的格式，包括 Markdown 表格和交互式 Chart.js 可视化。
📁 MCP 资源
动态资源创建，将转换后的数据存储为可从 MCP 服务器访问的资源。支持 Markdown 文档和可在浏览器中查看的交互式 HTML 报告。
📊 MCP 进度
在批量操作（例如，创建多个联系人记录、生成报告）期间提供实时进度通知，包括状态更新和完成跟踪。
🚀 快速开始
- 克隆仓库
- 将
appsettings.json复制到appsettings.local.json并配置数据verse 凭证 - 运行：
dotnet run --project MyDataverseMcpServer --environment Development - 服务器运行在
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 用于通过基于模板的生成实现交互式数据可视化
💻 使用示例
数据检索与资源创建
- 查询执行：使用
ExecuteFetch工具对数据verse 执行 FetchXML 查询 - 智能结果处理：MCP 启发提示用户将结果保存为资源
- 数据转换：MCP 采样将 JSON 转换为 Markdown 表格
- 资源创建：将格式化数据保存为带有描述性元数据的 MCP 资源
报告生成
- 数据输入：通过
CreateReportFromQuery或CreateReportFromData提供 FetchXML 查询或 CSV 数据 - 图表生成：MCP 采样根据数据和报告要求生成 Chart.js 代码
- 模板处理：将大语言模型生成的代码插入带有自定义标题的 HTML 模板
- 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 可视化。