azure-onenote-mcp-server

🚀 OneNote MCP 服务器

一个用于 Microsoft OneNote 的 Model Context Protocol (MCP) 服务器实现，使 AI 语言模型能够通过标准化接口与 OneNote 进行交互，为 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。

变更日志

0.1.0 (2025-04-27)

• 首次发布
• OneNote 笔记本、章节和页面管理的核心功能
• 发布到 npm 注册表

0.1.1 (2025-04-28)

• 修复环境变量配置问题
• 更新文档以提供清晰的安装步骤

📄 许可证

该项目在 MIT 许可证下可用，具体请查看 LICENSE 文件。