Sharepointmcp

🚀 用于 SharePoint の .NET MCP：グラフ API とセマンティック コアを使用した MCP サーバー

現代の企業環境において、特に人工知能機能と統合する際に、特定のデータに安全かつ効率的にアクセスすることは非常に重要です。例えば、スマートに会話するだけでなく、組織の SharePoint サイトから直接関連するドキュメントや情報を検索できるチャットボットを想像してみてください。この記事では、.NET、Microsoft Graph API、セマンティック コア、および Gemini AI を使用してこの目標を達成するためのモジュール化されたアーキテクチャについて概説します。

このプロジェクトは 3 つの異なるモジュールで構成されています。

1. セマンティック コア MCP サーバー：SharePoint と相互作用する核心コンポーネント。
2. SharePoint コネクター ライブラリ：SharePoint Online への詳細なアクセスを行う「手」。
3. Gemini AI の MCP クライアント（Gemini AI）：ユーザー向けのチャットインターフェース。

それでは、各モジュールを順番に分解してみましょう。

🚀 クイックスタート

このプロジェクトの概要と各モジュールの説明を通じて、SharePoint 検索ソリューションを構築するためのモジュール化されたアーキテクチャを理解できます。以下では各モジュールの詳細を見ていきます。

✨ 主な機能

• モジュール化されたアーキテクチャにより、フロントエンドとバックエンドのロジックが明確に分離され、保守と拡張が容易です。
• 新しい検索機能を簡単に追加したり、他のサービスを統合したりすることができます。
• .NET と Gemini 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 との通信の詳細を担当します。

目的：Microsoft Graph API を使用して認証し、検索から始まる特定の SharePoint 操作を実行します。 技術：.NET Standard または .NET Core ライブラリ、Microsoft.Graph SDK。 認証：クライアント ID とクライアント シークレットを使用して（アプリのみ認証）。 設定：Azure Active Directory (Azure AD) でアプリケーションを登録し、必要なグラフ API アクセス許可（例: Sites.Read.All または必要に応じてより細かいアクセス許可）を付与し、管理者の同意を得る必要があります。クライアント シークレットを安全に保存することが重要です（例: Azure Key Vault、.NET ユーザー シークレット） - 決してハードコードしないでください！

主要な機能：非同期関数（例: SearchSharePointAsync(string query)）で、以下のことを行います。

• クライアント ID とシークレットを使用して Microsoft Graph のアクセス トークンを取得します。
• SharePoint 検索エンドポイント (/search/query) へのグラフ API 要求を構築します。
• Microsoft.Graph SDK を使用して要求を送信します。
• 応答を解析し、関連する検索結果（例: ドキュメント名、リンク、抜粋）を返します。

モジュール 3：MCP クライアント（Gemini 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();
    // 結果を処理してユーザーに表示する
}