MCP Server Microsoft365 Filesearch

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

モデルコンテキストプロトコル (MCP) サーバーにより、Microsoft 365 環境での高度なファイル検索を実現します。SharePoint/OneDrive のコンテンツを提供することで、ファイルの発見、メタデータ分析、およびビジネスプロセスとの統合を効率化します。

🚀 クイックスタート

この MCP サーバーは、Microsoft 365 環境での高度なファイル検索機能を提供します。以下では、サーバーの各コンポーネントや使用方法、設定方法について説明します。

✨ 主な機能

• モデルコンテキストプロトコル (MCP) サーバーを通じて、Microsoft 365 環境での高度なファイル検索を可能にします。
• ファイルの発見、メタデータ分析、およびビジネスプロセスとの統合を効率化します。
• サーバーには search_m365_files と get_file_content の 2 つのコアツールがあり、それぞれファイル検索と特定ファイルの内容取得を行います。
• ローカルキャッシュを利用して、性能を向上させ、冗長な API 呼び出しを減らします。
• Claude Desktop との統合が可能です。

📦 インストール

このサーバーを使用するには、Microsoft Graph アプリケーションの登録が必要です。以下の手順に従ってください：

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

💻 使用例

基本的な使用法

search_m365_files の使用

# search_m365_files を使用して、Microsoft 365 環境でファイルを検索する
# 入力: query (文字列) - 検索語または条件
# 返り値: ファイルメタデータオブジェクトの配列

get_file_content の使用

# get_file_content を使用して、特定のファイルの内容を取得する
# 入力: driveid (文字列) - 親ドライブの一意の識別子
#       fileid (文字列) - ファイルの一意の識別子
# 返り値: バイナリストリームとしてのファイル内容

高度な使用法

Claude Desktop との統合

claude_desktop_config.json を更新して、サーバーを Claude Desktop と統合します。

"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 Graph クライアントシークレット",
      "TENANT_ID": "テナント ID",
      "REGION": "検索領域"
    }
  }
}

🔧 技術詳細

コンポーネント

ツール

サーバーは 2 つのコアツールを提供します：

• search_m365_files

  • Microsoft 365 環境でファイル検索を実行します。
  • 入力:
    • query (文字列)：検索語または条件。
  • 返り値: ファイルメタデータオブジェクトの配列。メタデータには、ファイル内容の要約、ドライブ ID、ファイル ID などの詳細が含まれます。

• get_file_content

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

キャッシュ

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

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

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

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。適切な引用を追加することで、自由に使用、変更、配布することができます。