金大哥 - azure-onenote-mcp-server MCP 详情

article

README

🚀 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 应用注册

访问 Azure Portal 并导航到应用注册。
创建新的注册。
添加 Microsoft Graph API 权限：
- Notes.ReadWrite.All
- Notes.Read.All
创建客户端密钥。
复制租户 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 文件。

azure-onenote-mcp-server