notnative

📝 一站式本地笔记管理专家

基于 MCP 协议连接本地 Notnative,提供笔记管理、任务日历、Python 数据分析等 86 项工具,实现本地化知识工作流闭环。

收藏
10.4k
安装
2.2k
版本
v1.0.1
CLS 安全性认证2026-05-04
点击查看完整报告 >

使用说明

Notnative 是一款专为本地知识管理设计的 MCP Skill,通过 WebSocket 协议与运行在本地 8788 端口的 Notnative 应用实例建立连接,为用户提供全方位的笔记管理与生产力工具集成。该 Skill 配备命令行客户端 mcp-client.js,封装了 86 个可用的 MCP 工具,涵盖笔记的增删改查、全文与语义搜索、日历事件管理、任务追踪、Python 代码执行以及 Canvas 可视化操作等核心功能。

核心用法上,用户可通过简单的 CLI 命令实现复杂的知识管理操作。基础命令支持笔记的搜索(包括语义搜索)、读取、创建、追加和更新;高级用法允许直接调用 MCP 工具进行日历事件创建、任务管理、网页浏览甚至 YouTube 转录获取。特别值得一提的是其 Python 执行功能,支持在本地环境中运行包含 matplotlib、pandas、numpy 等库的代码,直接生成数据分析图表和 Excel 报告,实现笔记与数据处理的深度整合。

该 Skill 的显著优点在于其本地优先的架构设计。所有数据通过 WebSocket 仅在本地传输(127.0.0.1),确保用户隐私数据不会上传至远程服务器,特别适合对数据安全敏感的用户。功能覆盖全面,从日常的笔记整理到复杂的项目管理(日历+任务),再到技术用户的代码执行需求,形成了完整的本地化工作流。与 Notnative 应用的深度集成也意味着用户可以无缝操作现有的笔记库,利用语义搜索快速定位历史知识。

然而,该 Skill 也存在一定局限性。首先,它完全依赖本地 Notnative 应用作为 MCP 服务器,若应用未运行或端口被占用则无法使用,灵活性受限。其次,Python 代码执行功能虽然强大,但将代码转发至本地服务器执行,如果服务器环境配置不当可能存在执行风险。此外,作为 T3 来源(个人开发者账号)的项目,长期维护的稳定性与官方支持相比存在不确定性。功能上目前仅支持 WebSocket 连接,缺乏远程访问能力,不适合需要多设备云同步的场景。

该 Skill 最适合已使用或计划使用 Notnative 作为主力笔记应用的用户,特别是注重数据隐私、偏好本地存储的开发者、研究人员和知识工作者。对于需要在笔记中直接进行数据分析、图表生成的技术用户,以及希望通过命令行自动化笔记管理流程的极客用户,该工具能显著提升工作效率。

使用风险方面,主要需注意本地 MCP 服务器的可信度,确保 Notnative 应用来源可靠。Python 代码执行环境应限制在受控范围内,避免执行不可信代码。WebSocket 连接的稳定性也直接影响使用体验,若本地应用响应缓慢可能导致请求超时(默认 10 秒限制)。此外,由于依赖特定本地应用,该 Skill 的可移植性较差,无法在其他笔记平台复用。

安全解读

核心用法

Notnative 是一个面向本地笔记应用 Notnative 的 MCP(Model Context Protocol)客户端 skill,通过 WebSocket 连接本地运行的 Notnative 实例(ws://127.0.0.1:8788),提供完整的笔记管理、日历任务、Python 执行、Canvas 图表等 86 项工具能力。

主要功能模块:

| 模块 | 核心能力 |
|------|---------|
| 笔记管理 | 全文/语义搜索、创建/读取/更新/删除、历史版本恢复、标签文件夹管理 |
| 日历任务 | 事件创建与查询、任务管理、空闲时间查找、任务转事件 |
| Python 执行 | 支持 matplotlib、pandas、numpy、openpyxl 等库,可生成图表和 Excel |
| Canvas 操作 | 节点增删、自动布局、转 Mermaid 等图表功能 |
| 高级搜索 | YouTube 字幕获取、网页浏览、语义搜索 |

典型使用场景:

  • 搜索并读取笔记内容,辅助知识问答
  • 自动创建日报、项目文档或任务清单
  • 执行 Python 进行数据分析并可视化
  • 管理个人日历和待办事项

显著优点

1. 本地化优先:所有数据仅在本地 WebSocket 通信,无云端上传,隐私性极强
2. 功能丰富:86 个 MCP 工具覆盖笔记全生命周期管理

3. 语义搜索:支持基于含义的内容检索,超越关键词匹配

4. Python 集成:内置数据科学生态,可直接生成图表和报告

5. 零依赖风险:单一依赖 ws@8.19.0 为知名稳定库

潜在局限

1. 应用依赖:必须预先安装并运行 Notnative 应用,且 MCP 服务器需启用
2. 本地限制:无法远程访问笔记数据,跨设备同步需依赖 Notnative 本身

3. 单点连接:仅支持单一本地端口(8788),无连接池或多实例支持

4. 超时限制:工具执行超过 10 秒会触发请求超时

5. 覆盖风险:update_note 会完全覆盖内容,误操作可能导致数据丢失(虽有历史版本可恢复)

适合人群

  • 使用 Notnative 作为主力笔记工具的知识工作者
  • 需要 AI 辅助进行本地知识库问答和整理的用户
  • 希望在笔记系统中集成 Python 数据分析的开发者
  • 注重数据隐私、不愿将笔记内容上传云端的技术用户

常规风险

  • 连接失败风险:Notnative 应用未启动或 MCP 服务器未启用时所有功能不可用
  • 误操作风险:update/append 等写操作需谨慎确认目标笔记名称
  • 版本兼容风险:MCP 协议版本不匹配可能导致部分工具异常
  • Python 执行风险:run-python 虽在本地沙箱运行,但仍需避免执行破坏性代码

notnative 内容

scripts文件夹
手动下载zip · 5.2 kB
mcp-client.jstext/javascript
请选择文件