🚀 用于 SharePoint 的 .NET MCP：使用图 API 和语义内核的 MCP 服务器

在现代企业环境中，安全且高效地访问特定数据至关重要，尤其是在与人工智能能力集成的场景下。想象有这样一个聊天机器人，它不仅能进行智能对话，还能直接从组织的 SharePoint 站点中检索相关文档或信息。本项目概述了一个模块化架构，借助 .NET、微软图 API、语义内核以及双子星 AI 来达成这一目标。

🚀 快速开始

本项目由三个不同的模块构成，下面为您逐步分解各模块：

✨ 主要特性

• 模块化架构：清晰分离前端和后端逻辑，便于维护和扩展。
• 可扩展性：能够轻松添加新的搜索功能或集成其他服务。
• 高性能：利用 .NET 和双子星 AI 的高效性能确保快速响应。

📦 安装指南

文档中未提及安装步骤，暂不展示。

💻 使用示例

基础用法

public async Task Search(string query)
{
    var response = await _httpClient.GetAsync($"https://api.yourbackend.com/search?q={query}");
    var result = await response.Content.ReadAsStringAsync();
    // 处理结果并显示给用户
}

高级用法

文档中未提及高级用法相关代码，暂不展示。

📚 详细文档

模块 1：.NET MCP 服务器（使用语义内核）

这个核心组件充当中心枢纽和 API 端点，它基于 .NET 构建，并集成了语义内核。虽然它可以是一个标准的 ASP.NET Core Web API，但借助语义内核，可将 SharePoint 交互定义为“技能”或“插件”。

通过 API 端点（例如 /api/sharepoint/search）公开功能（例如 SharePoint 搜索），该端点接受搜索查询。它会协调调用连接器库中的函数，使用 .NET（例如 ASP.NET Core Web API）、语义内核 SDK。

关键功能在于定义一个 API 路由（例如 /api/sharepoint/search），接受搜索查询，此路由将调用连接器库中的函数。由于使用了语义内核，可轻松将其集成到更复杂的 AI 推理流程中。

模块 2：SharePoint 连接器库（图 API）

这个 .NET 库专门负责与 SharePoint Online 通信的细节。

• 目的：使用微软图 API 进行身份验证并执行特定的 SharePoint 操作，从搜索开始。
• 技术：采用 .NET Standard 或 .NET Core 库，以及 Microsoft.Graph SDK。
• 身份验证：使用客户 ID 和客户秘密（仅应用认证）。
• 设置：需要在 Azure Active Directory (Azure AD) 中注册一个应用程序，授予其必要的图 API 权限（例如 Sites.Read.All 或更精细的权限，具体取决于您的需求），并获得管理员同意。务必安全地存储您的客户秘密（例如 Azure 密钥 vault、.NET 用户秘密），切勿硬编码！

关键功能是有一个异步函数（例如 SearchSharePointAsync(string query)），它会使用客户 ID 和秘密获取 Microsoft Graph 的访问令牌，构建图 API 请求到 SharePoint 搜索端点 (/search/query)，发送请求并使用 Microsoft.Graph SDK 解析响应，返回相关的搜索结果（例如文档名称、链接、摘录）。

模块 3：MCP 客户端（双子星 AI）

这是面向用户交互的应用程序，具有由 Gemini AI 提供支持的聊天界面。

• 目的：提供基于人工智能的对话体验，识别用户与 SharePoint 相关的意图，并将任务委托给 MCP 服务器。
• 技术：可基于任何客户端平台（.NET MAUI、Blazor、控制台应用程序等）以及 Google AI Gemini SDK 构建。
• 功能：在用户输入文本时，将查询发送到后端服务，处理来自后端的响应，并根据需要格式化和显示结果。

🔧 技术细节

本项目通过模块化架构，使用 .NET、微软图 API、语义内核和双子星 AI 构建了一个 SharePoint 搜索解决方案。语义内核 MCP 服务器作为核心枢纽，通过 API 端点协调与 SharePoint 的交互；SharePoint 连接器库利用微软图 API 进行身份验证和操作执行；MCP 客户端借助双子星 AI 为用户提供聊天界面。各模块相互协作，实现了安全高效的 SharePoint 搜索功能。同时，模块化设计使得系统易于维护和扩展，可根据需求添加新功能或集成其他服务。

📄 许可证

文档中未提及许可证信息，暂不展示。