hwillGIT

@hwillGIT/onenote-mcp

0 Stars 396 次浏览 hwillGIT 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "onenote": {
      "args": [
        "-m",
        "onenote_mcp"
      ],
      "command": "python"
    }
  }
}

服务介绍

OneNote MCP 服务器

一个用于通过浏览器自动化浏览和与 OneNote 网页应用程序交互的 MCP（模型上下文协议）服务器。该服务器使 AI 助手和其他兼容 MCP 的客户端能够以编程方式浏览和与通过网页链接共享的 OneNote 笔记本进行交互。

功能

导航 OneNote 的层次结构（笔记本、分区、页面）
从 OneNote 读取页面内容
向现有页面添加新内容
创建新页面
在 OneNote 中搜索
截取当前视图的屏幕截图
在会话期间保持状态

要求

Python 3.10 或更高版本
browser-use 0.1.40 或更高版本
MCP SDK 1.2.0 或更高版本
Playwright
互联网连接
一个共享的 OneNote 笔记本 URL（必须无需认证即可访问）

安装

bash

克隆仓库或创建项目结构

然后导航到项目目录

cd onenote-mcp

安装包及其依赖项

pip install -e .

安装 Playwright 浏览器

playwright install

使用

独立模式

你可以直接运行服务器：

bash
python -m onenote_mcp

与 Claude Desktop 或其他 MCP 主机集成

通过编辑配置文件来配置你的 Claude Desktop 以使用 OneNote MCP 服务器：

json
{
"mcpServers": {
"onenote": {
"command": "python",
"args": ["-m", "onenote_mcp"]
}
}
}

启动 Claude Desktop，它将自动启动 OneNote MCP 服务器
在与 Claude 的聊天中使用可用工具：

你能帮我导航我的 OneNote 笔记本 https://example.com/my-shared-notebook 吗？
首先，请用这个 URL 打开 OneNote 并告诉我有哪些笔记本可用。

可用工具

launch_onenote(shared_url): 使用共享笔记本 URL 打开 OneNote 网页应用
get_all_notebooks(): 列出所有可用的笔记本
get_all_sections(): 列出当前笔记本中的所有分区
get_all_pages(): 列出当前分区中的所有页面
navigate_to_notebook_by_name(notebook_name): 跳转到指定名称的笔记本
navigate_to_section_by_name(section_name): 跳转到指定名称的分区
navigate_to_page_by_name(page_name): 跳转到指定名称的页面
get_current_page_content(): 获取当前页面的内容
add_content_to_page(content): 向当前页面添加内容
create_new_page_with_name(page_name): 创建新页面
search_in_onenote(search_term): 在 OneNote 中搜索特定术语
take_screenshot(): 截取当前视图的屏幕截图
get_onenote_state(): 获取当前状态信息
close_onenote(): 关闭 OneNote 会话并清理资源

工作原理

此 MCP 服务器使用 browser-use（一个浏览器自动化框架）与 OneNote 网页界面进行交互。它在兼容 MCP 的 AI 助手和 OneNote 网页应用程序之间建立了一座桥梁，实现了对 OneNote 功能的编程控制。

限制

仅适用于通过公共链接共享且无需认证的 OneNote 笔记本
如果 OneNote 网页界面发生变化，则可能需要调整服务器
浏览器自动化可能会有些脆弱，并且依赖于 UI 结构
性能可能会根据网络状况和 OneNote 的响应性而有所不同

故障排除

如果服务器无法连接到 OneNote，请确保共享链接无需登录即可访问
如果选择器失败，OneNote UI 可能已更改 - 检查服务器代码
对于其他问题，请检查服务器日志以获取错误详情

许可证

MIT

查看源码项目主页