【技术文档摘要】

OneNote MCP Server

这是一个针对 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 Server for Claude Desktop：

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 Desktop）中添加以下内容：

{
  "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 门户并导航到应用注册
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-27)

• 向 package.json 添加可执行 bin
• 解决 npx 命令无法确定要运行的可执行文件的问题
• 更新 README，提供清晰的运行说明