MCP Server Microsoft365 Filesearch

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

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

點擊查看相關資源

✨ 主要特性

• 提供在微軟 365 環境中的高級文件搜索功能。
• 具備文件發現、元數據分析能力，並可與業務流程集成。
• 利用本地緩存提高性能，減少冗餘 API 調用。

📦 安裝指南

文檔中未提及安裝步驟，暫不提供相關內容。

💻 使用示例

基礎用法

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

search_m365_files

在微軟 365 環境中執行文件搜索。

# 輸入：
# query (字符串)：搜索詞或條件。
# 返回值：文件元數據對象數組。元數據包括文件內容摘要、*驅動器 ID* 和 *文件 ID*，以及其他詳細信息。

get_file_content

檢索特定文件的內容。

# 輸入：
# driveid (字符串)：父驅動器的唯一標識符。
# fileid (字符串)：文件的唯一標識符。
# 返回值：作為二進制流的文件內容。
# 注意：使用本地緩存來加快重複訪問的速度。

高級用法

暫無高級用法相關內容。

📚 詳細文檔

組件

工具

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

• search_m365_files
  在微軟 365 環境中執行文件搜索。
  輸入：

  • query (字符串)：搜索詞或條件。
    返回值：文件元數據對象數組。元數據包括文件內容摘要、驅動器 ID 和 文件 ID，以及其他詳細信息。

• get_file_content
  檢索特定文件的內容。
  輸入：

  • driveid (字符串)：父驅動器的唯一標識符。
  • fileid (字符串)：文件的唯一標識符。
    返回值：作為二進制流的文件內容。
    注意：使用本地緩存來加快重複訪問的速度。

緩存

為了提高性能並減少冗餘 API 調用，服務器在本地緩存下載的文件。這對於處理大型文檔或頻繁訪問的文件特別有用。

• 緩存文件存儲在項目根目錄下的 ./src/mcp_m365_filesearch/.local/downloads 目錄中（相對於項目根目錄）。
• 當通過 get_file_content 請求文件時，服務器首先檢查緩存。
• 如果文件已存在緩存中，則直接從磁盤返回，而不進行新的 API 調用。

此功能確保了更快的響應時間和更高效地使用 API 速率限制。

與 Claude Desktop 集成

要將服務器與 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 圖秘密客戶",
      "TENANT_ID": "租戶 ID",
      "REGION": "搜索區域"
    }
  }
}

微軟圖應用註冊

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

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

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

📄 許可證

該項目根據 MIT License 發佈。您可以自由使用、修改和分發該軟件，只要註明出處即可。