OneNote MCP 服务器

一个用于通过浏览器自动化浏览和交互 OneNote 网页应用的 Model Context Protocol (MCP) 服务器。此服务器使 AI 助手和其他兼容 MCP 的客户端能够以编程方式浏览和与通过网络链接共享的 OneNote 笔记本进行交互。

特性

• 浏览 OneNote 的分层结构（笔记本、部分、页面）
• 从 OneNote 读取页面内容
• 向现有页面添加新内容
• 创建新页面
• 在 OneNote 中搜索
• 截取当前视图的屏幕截图
• 维护会话中的状态

需求

• Python 3.10 或更高版本
• browser-use 0.1.40 或更高版本
• MCP SDK 1.2.0 或更高版本
• Playwright
• 网络连接
• 一个可通过网络链接共享的 OneNote 笔记本 URL（无需身份验证即可访问）

安装

# 克隆仓库或创建项目结构
# 然后导航到项目目录
cd onenote-mcp

# 安装包和依赖项
pip install -e .

# 安装 Playwright 浏览器
playwright install

使用方法

单独运行模式

可以直接运行服务器：

python -m onenote_mcp

与 Claude Desktop 或其他 MCP 主机集成

1. 配置您的 Claude Desktop 使用 OneNote MCP 服务器，通过编辑配置文件：

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

2. 启动 Claude Desktop，它会自动启动 OneNote MCP 服务器
3. 在与 Claude 的聊天中使用提供的工具：

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

可用工具

• launch_onenote(shared_url): 使用共享的 notebook 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 的响应速度而有所不同

注意事项

• 请确保安装了所有必需的依赖项（Python、browser-use、MCP SDK 和 Playwright）
• 在运行服务器之前，请确保您有有效的 OneNote 笔记本 URL
• 如果遇到任何问题，请检查日志或查阅相关文档