Azure Onenote MCP Server

🚀 OneNote MCP 服務器

OneNote MCP 服務器是一個用於 Microsoft OneNote 的 Model Context Protocol (MCP) 服務器實現，它讓 AI 語言模型能夠藉助標準化接口與 OneNote 進行交互，為相關應用開發提供了便利。

🚀 快速開始

本項目是一個用於 Microsoft OneNote 的 Model Context Protocol (MCP) 服務器實現，藉助它，AI 語言模型可通過標準化接口與 OneNote 交互。下面為你介紹其安裝和使用的基本步驟。

✨ 主要特性

筆記本管理

• 📋 列出所有筆記本
• ➕ 創建新筆記本
• ℹ️ 獲取筆記本詳細信息
• 🗑️ 刪除筆記本

章節管理

• 📋 列出筆記本中的章節
• ➕ 創建新章節
• ℹ️ 獲取章節詳細信息
• 🗑️ 刪除章節

頁面管理

• 📋 列出章節中的頁面
• ➕ 使用 HTML 內容創建新頁面
• 📖 讀取頁面內容
• ✏️ 更新頁面內容
• 🗑️ 刪除頁面
• 🔍 在筆記本中搜索頁面

📦 安裝指南

從 npm 安裝（推薦）

npm install -g mcp-server-onenote

該包自 2025 年 4 月 27 日起已在 npm 註冊表可用。

運行包

安裝完成後，可使用以下命令運行：

mcp-server-onenote

或通過 npx 運行：

npx mcp-server-onenote

使用 Smithery 安裝

要通過 Smithery 自動安裝 OneNote 服務器以用於 Claude 桌面版本，可執行以下命令：

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

從 GitHub 安裝

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

📚 詳細文檔

配置

需設置以下環境變量：

• AZURE_TENANT_ID：你的 Azure 租戶 ID
• AZURE_CLIENT_ID：你的 Azure 應用（客戶端）ID
• AZURE_CLIENT_SECRET：你的 Azure 客戶端密鑰

與 MCP 客戶端一起使用

將以下內容添加到你的 MCP 客戶端配置文件中（例如用於 Claude 桌面）：

{
  "mcpServers": {
    "onenote": {
      "command": "mcp-server-onenote",
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Azure 應用註冊

1. 訪問 Azure Portal 並導航到應用註冊。
2. 創建新的註冊。
3. 添加 Microsoft Graph API 權限：
   • Notes.ReadWrite.All
   • Notes.Read.All
4. 創建客戶端密鑰。
5. 複製租戶 ID、客戶端 ID 和客戶端密鑰以進行配置。

開發

# 安裝依賴
npm install

# 運行測試
npm test

# 構建
npm run build

# 格式化
npm run lint

# 本地運行
npm start

貢獻

有關貢獻信息，請參閱 CONTRIBUTING.md。

許可證

該項目在 MIT 許可證下可用，具體請查看 LICENSE 文件。

變更日誌

0.1.0 (2025-04-27)

• 🎉 首次發佈
• 具備 OneNote 筆記本、章節和頁面管理的核心功能
• 發佈到 npm 註冊表

0.1.1 (2025-04-28)

• 🐛 修復環境變量配置問題
• 📝 更新文檔以提供清晰的安裝步驟