Onenote Browser

🚀 OneNote MCP 服務器

OneNote MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它藉助瀏覽器自動化技術，實現了在網頁端對 OneNote 應用的瀏覽與交互。通過該服務器，AI 助手及其他兼容 MCP 的客戶端能夠以編程方式訪問並操作通過網絡鏈接共享的 OneNote 筆記本。

✨ 主要特性

• 支持瀏覽 OneNote 的分層結構，涵蓋筆記本、部分和頁面。
• 可從 OneNote 中讀取頁面內容。
• 能夠向現有頁面添加新內容。
• 支持創建新頁面。
• 具備在 OneNote 中進行搜索的功能。
• 可以截取當前視圖的屏幕截圖。
• 能夠維護會話中的狀態。

📦 安裝指南

# 克隆倉庫或創建項目結構
# 然後導航到項目目錄
cd onenote-mcp

# 安裝包和依賴項
pip install -e .

# 安裝 Playwright 瀏覽器
playwright install

💻 使用示例

基礎用法

單獨運行模式

可以直接運行服務器：

python -m onenote_mcp

與 Claude Desktop 或其他 MCP 主機集成

1. 配置您的 Claude Desktop 使用 OneNote MCP 服務器，通過編輯配置文件：

{
  "mcpServers": {
    "onenote": {
      "command": "python",
      "args": ["-m", "onenote_mcp"]
    }
  }
}

2. 啟動 Claude Desktop，它會自動啟動 OneNote MCP 服務器。
3. 在與 Claude 的聊天中使用提供的工具：

你能幫我導航到我的 OneNote 筆記本 https://example.com/my-shared-notebook 嗎？
首先，請打開此 URL 的 OneNote 並告訴我有哪些筆記本可用。

高級用法

以下是可用工具的介紹，可根據需求在代碼中調用這些工具實現不同功能：

• launch_onenote(shared_url): 使用共享的 notebook URL 打開 OneNote 網頁應用
• get_all_notebooks(): 列出所有可用的筆記本
• get_all_sections(): 列出當前筆記本中的所有部分
• get_all_pages(): 列出當前部分中的所有頁面
• navigate_to_notebook_by_name(notebook_name): 跳轉到特定的筆記本
• navigate_to_section_by_name(section_name): 跳轉到特定的部分
• navigate_to_page_by_name(page_name): 跳轉到特定的頁面
• get_current_page_content(): 獲取當前頁面的內容
• add_content_to_page(content): 向當前頁面添加內容
• create_new_page_with_name(page_name): 創建一個新頁面
• search_in_onenote(search_term): 在 OneNote 中搜索特定術語
• take_screenshot(): 截取當前視圖的屏幕截圖
• get_onenote_state(): 獲取當前狀態信息
• close_onenote(): 關閉 OneNote 會話並清理資源

🔧 技術細節

此 MCP 服務器使用 browser-use，一個瀏覽器自動化框架，來與 OneNote 網頁界面交互。它在 MCP 兼容 AI 助手和 OneNote 網絡應用之間創建了橋樑，實現了對 OneNote 功能的程序化控制。

📚 詳細文檔

侷限性

• 僅適用於通過公共鏈接共享（無需身份驗證）的 OneNote 筆記本。
• 如果 OneNote 網頁界面發生變化，服務器可能需要調整。
• 瀏覽器自動化在某種程度上可能脆弱且依賴於 UI 結構。
• 性能可能會因網絡條件和 OneNote 的響應速度而有所不同。

注意事項

⚠️ 重要提示

請確保安裝了所有必需的依賴項（Python、browser-use、MCP SDK 和 Playwright），在運行服務器之前，請確保您有有效的 OneNote 筆記本 URL，如果遇到任何問題，請檢查日誌或查閱相關文檔。