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

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

该项目由三个不同的模块组成：

1. 语义内核 MCP 服务器：与 SharePoint 相互作用的核心组件。
2. SharePoint 连接器库：深入访问 SharePoint Online 的“手”。
3. Gemini AI 的 MCP 客户端（双子星 AI）：面向用户的聊天界面。

让我们逐步分解每个模块：

模块 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。 功能：

• 在用户输入文本时，将查询发送到后端服务。
• 处理来自后端的响应，并根据需要格式化和显示结果。

示例代码片段：

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

优势

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

通过这个模块化的架构，您可以构建一个高效且易于管理的 SharePoint 搜索解决方案。