Onenotemcp

🚀 OneNote的MCP項目

本項目是一個用於OneNote的MCP（Microsoft Cloud Partner），在原始項目基礎上進行了重大修改。如今，它支持個人筆記本，更新到了最新的MCP API版本，還實現了憑證緩存功能，為用戶提供更高效、穩定的使用體驗。

🚀 快速開始

Azure應用註冊

1. 登錄Azure Portal，進入應用註冊界面。
2. 為OneNoteMCP創建一個新的應用註冊。
3. 添加Microsoft Graph API權限：
   • Notes.Read
   • Notes.Read.All
   • （可選）添加Notes.Write權限（存在筆記丟失風險）
4. 創建客戶端密鑰。
5. 複製獲取的客戶ID和密鑰用於後續配置。
6. 在應用manifest中將signInAudience設置為AzureADandPersonalMicrosoftAccount。

MCP服務器搭建

將客戶ID和密鑰放入本地.env文件，並在Claude桌面也進行相應配置。AUTH_CACHE_DIR應指定緩存憑證的存放目錄。

AZURE_CLIENT_ID=\
AZURE_CLIENT_SECRET=
AUTH_CACHE_DIR="C:\\git\\azure-onenote-mcp-server\\.cache"

首次運行服務器以生成並緩存認證憑證，之後Claude桌面將使用這些緩存運行服務。

npm install
npm build
npm run

當服務器啟動後，可通過以下命令直接測試API是否正常工作： {"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "listNotebooks", "arguments": {}}}

Claude MCP配置示例

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["C:\\git\\azure-onenote-mcp-server\\dist\\index.js"],
      "env": {
        "AZURE_CLIENT_ID": "...",
        "AZURE_CLIENT_SECRET": "...", 
        "AUTH_CACHE_DIR": "C:\\git\\azure-onenote-mcp-server\\.cache"
      }
    }
  }
}

✨ 主要特性

功能改進

• 修復了getPageContent功能，通過實現ReadableStream。
• 成功調用針對個人筆記本的API。
• 更新索引和工具以使用最新MCP版本。

代碼架構優化

• 簡化了代碼庫，移除了不必要的類。
• 刪除了很多冗餘文件。

認證與性能優化

• 實現了磁盤緩存用於存儲認證憑證。
• 更新依賴項包。
• 加入dotenv支持以實現本地直接測試能力。