MCP Server Microsoft365 Filesearch

🚀 MCP 服務器 - 微軟 365 文件搜索（ SharePoint 和 OneDrive）

本項目是一個模型上下文協議 (MCP) 服務器實現，可在 Microsoft 365 環境中進行高級文件搜索。它能高效實現文件發現、元數據分析，還可與業務流程集成，為用戶提供來自 SharePoint/OneDrive 的內容。

🚀 快速開始

若要將服務器與 Claude Desktop 集成，請更新 claude_desktop_config.json：

"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": "搜索區域"
    }
  }
}

✨ 主要特性

• 提供高級文件搜索功能，可在 Microsoft 365 環境中高效進行文件發現和元數據分析。
• 提供兩個核心工具，方便進行文件搜索和內容檢索。
• 採用本地緩存機制，提高性能並減少冗餘 API 調用。
• 可與 Claude Desktop 集成，拓展使用場景。

📦 安裝指南

要使用此服務器，您需要在 Azure 門戶 中註冊一個應用程序：

1. 註冊一個新的應用。
2. 記錄下 客戶端 ID 和 租戶 ID。
3. 在 證書和密鑰 下創建一個 客戶端密鑰。
4. 在 API 權限 下，添加以下 委派或應用權限：
   • Sites.Read.All
   • Files.Read.All
5. 點擊 授予管理員同意 這些權限。

確保這些值在 MCP 服務器的環境配置中正確設置。

💻 使用示例

基礎用法

該服務器提供兩個核心工具，以下是它們的使用示例：

search_m365_files

# 在 Microsoft 365 環境中執行文件搜索
# 輸入：query (字符串)：搜索詞或條件
# 返回：文件元數據對象數組。元數據包括文件內容摘要、*驅動器 ID* 和 *文件 ID* 等詳細信息
result = search_m365_files(query="example_query")

get_file_content

# 檢索特定文件的內容
# 輸入：
# - driveid (字符串)：父驅動器的唯一標識符。
# - fileid (字符串)：文件的唯一標識符。
# 返回：作為二進制流的文件內容
# 注意：使用本地緩存來加速重複訪問
content = get_file_content(driveid="example_driveid", fileid="example_fileid")

高級用法

# 結合兩個工具，先搜索文件，再獲取文件內容
search_result = search_m365_files(query="example_query")
for file in search_result:
    driveid = file["driveid"]
    fileid = file["fileid"]
    content = get_file_content(driveid=driveid, fileid=fileid)
    # 對文件內容進行進一步處理

🔧 技術細節

組件

工具

該服務器提供兩個核心工具：

• search_m365_files：在 Microsoft 365 環境中執行文件搜索，輸入搜索詞或條件，返回文件元數據對象數組。
• get_file_content：檢索特定文件的內容，輸入父驅動器的唯一標識符和文件的唯一標識符，返回作為二進制流的文件內容。使用本地緩存來加速重複訪問。

緩存

為了提高性能並減少冗餘 API 調用，服務器在本地緩存下載的文件。緩存文件存儲在項目根目錄下的 ./src/mcp_m365_filesearch/.local/downloads 目錄中（相對路徑）。當通過 get_file_content 請求文件時，服務器首先檢查緩存，如果文件已緩存，則直接從磁盤返回而無需新的 API 調用。

與 Claude Desktop 集成

要將服務器與 Claude Desktop 集成，請更新 claude_desktop_config.json，配置相關的命令、參數和環境變量。

📄 許可證

此項目根據 MIT License 發佈。您可以在自由地使用、修改和分發該項目，只需添加適當的引用即可。