MCP Server Microsoft365 Filesearch

🚀 MCP サーバー - マイクロソフト 365 ファイル検索（SharePoint と OneDrive）

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーを実装し、マイクロソフト 365 環境での高度なファイル検索機能を提供します。サーバーは、SharePoint や OneDrive からのコンテンツを活用して、効率的なファイル検索、メタデータ分析、および業務プロセスとの統合を実現します。

https://github.com/user-attachments/assets/bbe63c02-f6d9-4c9b-8f98-36fc22a081cc

✨ 主な機能

📦 コンポーネント

ツール

このサーバーは 2 つの核心的なツールを提供します。

• search_m365_files マイクロソフト 365 環境でファイル検索を実行します。 入力:

  • query (文字列): 検索キーワードまたは条件。 戻り値: ファイルのメタデータオブジェクトの配列。メタデータには、ファイル内容の要約、ドライブ ID および ファイル ID などの詳細情報が含まれます。

• get_file_content 特定のファイルの内容を取得します。 入力:

  • driveid (文字列): 親ドライブの一意の識別子。
  • fileid (文字列): ファイルの一意の識別子。 戻り値: バイナリストリームとしてのファイル内容。 注意: 繰り返しのアクセスを高速化するために、ローカルキャッシュを使用します。

キャッシュ

サーバーは、ダウンロードしたファイルをローカルキャッシュに保存することで、パフォーマンスを向上させ、冗長な API 呼び出しを減らします。これは、大きなドキュメントや頻繁にアクセスするファイルを処理する際に特に有効です。

• キャッシュされたファイルは、プロジェクトのルートディレクトリから ./src/mcp_m365_filesearch/.local/downloads ディレクトリに保存されます。
• get_file_content でファイルを要求すると、サーバーはまずキャッシュを確認します。
• キャッシュにファイルが存在する場合は、新しい API 呼び出しを行わずにディスクから直接返します。

この機能により、応答時間が短縮され、API のレート制限が効率的に使用されます。

💻 使用例

基本的な使用法

"mcpServers": {
  "M365 File Search (SharePoint/OneDrive)": {
    "command": "uv",
    "args": [
      "--directory",
      "full_path_to_parent_directory",
      "run",
      ".\\src\\mcp_m365_filesearch\\server.py"
    ],
    "env": {
      "CLIENT_ID": "MSGraph クライアント ID",
      "CLIENT_SECRET": "MS グラフのクライアントシークレット",
      "TENANT_ID": "テナント ID",
      "REGION": "検索リージョン"
    }
  }
}

🔧 クロードデスクトップとの統合

サーバーを Claude Desktop と統合するには、claude_desktop_config.json を更新してください。

🔑 マイクロソフト グラフのアプリ登録

このサーバーを使用するには、Azure Portal でアプリケーションを登録する必要があります。

1. 新しいアプリケーションを登録します。
2. クライアント ID と テナント ID を記録します。
3. 証明書とシークレット の下で クライアントシークレット を作成します。
4. API アクセス許可 の下で、次の 委任またはアプリケーションのアクセス許可 を追加します。
   • Sites.Read.All
   • Files.Read.All
5. 管理者の同意を付与する をクリックして、これらのアクセス許可を承認します。

これらの値が MCP サーバーの環境設定に正しく設定されていることを確認してください。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。ソフトウェアを自由に使用、変更、配布することができますが、著作権表示を含める必要があります。