OneNote MCP服务器

一个用于Microsoft OneNote的模型上下文协议(MCP)服务器,支持通过Claude Desktop或任何MCP兼容客户端读取和创建笔记本、分区和页面。

  • by FRESHSK
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 FRESHSK/onenote-mcp-server

使用说明

OneNote MCP服务器 Microsoft OneNote的模型上下文协议(MCP)服务器,允许通过Claude Desktop或任何兼容MCP的客户端读取和创建笔记本、分区和页面。

特性 🔐 通过Microsoft设备代码流进行安全身份验证 📚 列出所有OneNote笔记本 📑 浏览笔记本中的分区 📄 按部分查看页面 ✍️ 创建新的笔记本、分区和页面 💾 用于无缝重新身份验证的令牌缓存 🔧 完整的MCP协议实施 先决条件 Node.js 14.0.0或更高版本 使用Graph API权限注册Microsoft Azure AD应用程序 Claude Desktop(或任何兼容MCP的客户端) 快速开始 克隆存储库: bash 克隆https://github.com/YOUR_USERNAME/onenote-mcp-server.git cd onenote mcp服务器 安装依赖项: bash npm安装 设置Azure AD应用程序注册(请参阅下面的“设置”部分) 配置Claude Desktop(请参阅下面的配置部分) 设置

  1. 创建Azure AD应用程序注册 转到Azure门户 导航到Azure Active Directory→ 应用程序注册→ 新注册 命名您的应用程序(例如,“OneNote MCP服务器”) 选择“任何组织目录中的帐户和个人Microsoft帐户” 将重定向URI设置为“公共客户端/本地”,值为: https://login.microsoftonline.com/common/oauth2/nativeclient 创建后,记下应用程序(客户端)ID
  2. 配置API权限 在您的应用程序注册中,转到API权限 添加以下Microsoft Graph委派权限: 笔记。阅读 笔记。创建 笔记。读写 用户。阅读 如果需要,授予管理员同意
  3. 配置Claude桌面 将以下内容添加到您的Claude Desktop配置文件中:

Windows:%APPDATA%\Claude\Claude_desktop_config.json macOS:~/库/应用程序支持/Claude/Claude_desktop_config json Linux:~/.config/Claude/Claude_desktop_config json

数据 { “mcpServers”:{ “onenote”:{ “command”:“node”, “args”:[“/path/to/onenote mcp服务器/server.js”], “env”:{ “AZURE_CLIENT_ID”:“此处为您的AZURE客户端ID” } } } } 将/path/to/onenote mcp server/替换为克隆存储库的实际路径。

用法 配置后,您可以通过Claude Desktop与OneNote交互:

“列出我的OneNote笔记本” “创建一个名为“我的想法”的新笔记本” “显示笔记本“工作笔记”中的部分” 在“2024年1月”部分创建一个名为“会议笔记”的页面 “阅读“项目计划”页面的内容” API文档 工具 onenote阅读 阅读OneNote内容(笔记本、分区、页面)。

参数:

type:操作类型 list_notebooks:列出所有笔记本 list_sections:列出笔记本中的分区 list_pages:列出部分中的页面 read_content:读取页面内容 notebookId:list_sections需要 sectionId:list_pages需要 pageId:read_content需要 onenote创建 创建OneNote内容(笔记本、分区、页面)。

参数:

type:操作类型 create_notebook:创建新笔记本 create_section:创建一个新节 create_page:创建新页面 displayName:笔记本和分区必需 notebookId:create_section需要 sectionId:创建页面需要 title:页面必需 content:页面的HTML内容(可选) 故障排除 身份验证问题 确保您的Azure客户端ID正确 检查是否授予了所有必需的权限 删除.mcp-onnote-cache.json以强制重新身份验证 连接问题 检查Claude Desktop日志中的错误消息 验证配置中的服务器路径 确保Node.js已安装且可访问 常见错误 MODULE_NOT_FOUND:运行npm install安装依赖项 无效授权:删除令牌缓存文件并重新进行身份验证 权限被拒绝:检查Azure AD权限 安全 永远不要将Azure客户端ID提交到版本控制 .mcp-onnote-cache.json文件包含敏感令牌,它会通过.gitignore自动排除 使用环境变量或Claude Desktop的配置作为凭据 贡献 分叉存储库 创建一个功能分支(git checkout-b功能/惊人功能) 提交你的更改(git Commit-m'添加惊人的功能') 推送到分支(git推送原点功能/惊人功能) 打开拉取请求 许可证 此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

致谢 用于OneNote集成的Microsoft Graph API Claude Desktop支持MCP 模型上下文协议社区 支持 对于问题和疑问:

在GitHub上打开一个问题 检查MCP文档 查看Microsoft Graph API文档