OneNote MCP 服务器

一个为 Microsoft OneNote 实现的模型上下文协议 (MCP) 服务器,使 AI 语言模型能够通过标准化接口与 OneNote 交互。

  • by ZubeidHendricks
  • TypeScript
  • 本地部署
  • 27 星标
  • 更新于
在 GitHub 查看 ZubeidHendricks/azure-onenote-mcp-server

使用说明

OneNote MCP服务器

Microsoft OneNote的模型上下文协议(MCP)服务器实现,使AI语言模型能够通过标准化界面与OneNote交互。

特性

笔记本管理

  • 列出所有笔记本
  • 创建新笔记本
  • 获取笔记本详细信息
  • 删除笔记本

科室管理

  • 列出笔记本中的分区
  • 创建新部分
  • 获取部分详细信息
  • 删除部分

页面管理

  • 在一个部分中列出页面
  • 使用HTML内容创建新页面
  • 阅读页面内容
  • 更新页面内容
  • 删除页面
  • 跨笔记本搜索页面

安装

从npm安装(推荐)

npm install -g mcp-server-onenote

截至2025年4月27日,该包已在npm注册表上可用。

运行包

安装后,您可以使用以下命令运行该包:

mcp-server-onenote

或者使用npx:

npx mcp-server-onenote

通过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权限:
    • 笔记。读写。全部
    • 笔记。读。全部
  4. 创建客户端密钥
  5. 复制租户ID、客户端ID和客户端密钥以进行配置

发展

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

# Run locally
npm start

贡献

看 贡献.md 有关为此存储库做出贡献的信息。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 详细信息文件

更新日志

0.1.0 (2025-04-27)

  • 初始版本
  • OneNote笔记本、分区和页面管理的核心功能
  • 发布到npm注册表

0.1.1 (2025-04-27)

  • 将可执行bin添加到package.json中
  • 修复了npx命令无法确定要运行的可执行文件的问题
  • 更新了README,其中包含清晰的运行说明