Sharepointmcp

🚀 用於 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 搜索功能。同時，模塊化設計使得系統易於維護和擴展，可根據需求添加新功能或集成其他服務。

📄 許可證

文檔中未提及許可證信息，暫不展示。