使用说明

项目简介

OneNote Server MCP (OneNote MCP Server) 是一个 MCP 服务器的实现，旨在连接 AI 语言模型和 Microsoft OneNote。通过这个服务器，AI 模型可以像操作本地文件一样，以标准化的方式访问和管理 OneNote 中的笔记内容，例如创建笔记本、检索页面、搜索信息等。这为构建基于 OneNote 知识库的 AI 应用提供了便利。

主要功能点

笔记本管理：
- 列出所有笔记本
- 创建新的笔记本
- 获取笔记本详情
- 删除笔记本
分区管理：
- 列出笔记本中的分区
- 创建新的分区
- 获取分区详情
- 删除分区
页面管理：
- 列出分区中的页面
- 创建新的页面（支持HTML内容）
- 读取页面内容
- 更新页面内容
- 删除页面
- 在笔记本中搜索页面

所有功能均通过 MCP 协议以标准化的 JSON-RPC 接口提供，方便各种 MCP 客户端集成。

安装步骤

安装 Node.js 和 npm：确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
全局安装 'mcp-server-onenote' 包：打开终端或命令提示符，运行以下命令进行全局安装：
```
npm install -g mcp-server-onenote
```

服务器配置

MCP 服务器需要配置 Azure 应用程序的凭据才能访问 OneNote。请按照以下步骤配置环境变量：

注册 Azure 应用程序：
- 访问 Azure Portal (https://portal.azure.com) 并导航到“应用注册”。
- 创建新的应用程序注册。
- 添加 Microsoft Graph API 权限：
  - 'Notes.ReadWrite.All'
  - 'Notes.Read.All'
- 创建客户端密码。
- 复制 目录 (租户) ID、应用程序 (客户端) ID 和 客户端密码值。

配置 MCP 客户端：在你的 MCP 客户端（例如 Claude Desktop）的配置文件中，添加以下服务器配置。请将 '<YOUR_TENANT_ID>'、'<YOUR_CLIENT_ID>' 和 '<YOUR_CLIENT_SECRET>' 替换为你从 Azure 应用程序注册中获取的实际值。

{
  "mcpServers": {
    "onenote": {
      "command": "npx",
      "args": ["-y", "mcp-server-onenote"],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",  // 替换为你的 Azure 租户 ID
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",  // 替换为你的 Azure 客户端 ID
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>" // 替换为你的 Azure 客户端密码
      }
    }
  }
}

配置说明：

'server name': 'onenote' (服务器名称，客户端用此名称引用)
'command': 'npx' (用于执行 Node.js 包的命令)
'args': '["-y", "mcp-server-onenote"]' (启动 'mcp-server-onenote' 包的参数，'-y' 参数用于跳过 'npx' 的确认提示)
'env': 环境变量配置，用于传递 Azure 应用程序的凭据

基本使用方法

配置完成后，你的 MCP 客户端应该能够连接到 OneNote Server MCP。你可以通过客户端提供的界面或指令，调用服务器提供的各种功能，例如：

让 AI 模型列出你的 OneNote 笔记本，并选择一个笔记本进行操作。
指示 AI 模型在指定的 OneNote 分区中创建新的页面，并将某些信息写入页面内容。
要求 AI 模型搜索 OneNote 中包含特定关键词的页面。

具体的使用方式取决于你使用的 MCP 客户端的功能和界面。请参考你的 MCP 客户端的文档来了解如何使用配置的 MCP 服务器。

关键词