NoteExpress MCP 升级：支持“增删改查”功能！

aegeansupport

通过 MCP 您可以在 NeClaw、Claude Desktop、Cursor、VS Code 等 AI 助手中直接操作本机的 NoteExpress：搜索文献、查看题录、阅读笔记、导入 PDF 等。

强烈推荐使用 NeClaw
如果您希望获得开箱即用的体验，建议直接使用 NeClaw。
目前 NeClaw 已内嵌 NoteExpress MCP，无需任何复杂的配置即可直接调用。
下载 NeClaw 请访问：《NeClaw发布：专为科研打造的桌面端AI Agent》帖子
️
使用前请确认（重要）
必须安装 NoteExpress V4.3.0.10700版本，旧版本不支持本 MCP 协议。
操作系统： 仅支持 Windows 电脑。
[点击此处下载 NoteExpress v4.3.0.10700]



如何手动安装配置
(如果您使用的是 NeClaw，请跳过此步骤)
在 Agent 客户端的 MCP 设置中新增一项（Claude 多在「设置 → MCP」；Cursor 多为「设置 → MCP」或 .cursor/mcp.json）：

1. {
   
2.   "mcpServers": {
   
3.     "ne-mcp": {
   
4.       "url": "http://127.0.0.1:49527/mcp",
   
5.       "transport": "streamable_http"
   
6.     }
   
7.   }
   
8. }

复制代码

已实现的功能

配置成功后，Agent 可通过 MCP 调用下表能力。您无需记住工具名，用自然语言说明需求即可；下表便于了解「能做什么」。
【查询类】

• noteexpress_search_refs
  功能：在当前题录库中按条件搜索文献（不含笔记正文）
  参数：标题、作者、DOI、年份、标签、关键词等（可组合）
• noteexpress_get_ref
  功能：按编号查看单条文献的完整信息（含附件、笔记、所在文件夹等）
  参数：文献 UID（必填）
• noteexpress_list_refs
  功能：按文件夹分页列出文献
  参数：页码、每页条数、文件夹等
• noteexpress_get_note
  功能：读取一条笔记内容
  参数：笔记编号或笔记 UID（二选一）
• noteexpress_list_attaches
  功能：列出某条文献的附件清单
  参数：文献 UID（必填）
  
  
  
  
  
  

【库与目录管理类】

• noteexpress_list_libraries
  功能：列出当前已打开的所有题录库
  参数：可选：指定要激活的库
• noteexpress_open_library
  功能：打开本机上的题录库文件（.ndb / .nel）
  参数：题库文件路径（必填）
• noteexpress_list_categories
  功能：查看文件夹目录树（含各文件夹下文献数量）
  
• noteexpress_create_category
  功能：在指定位置新建文件夹
  参数：文件夹标题（必填）
• noteexpress_update_category
  功能：重命名文件夹
  参数：文件夹编号、标题
• noteexpress_delete_category
  功能：删除文件夹（文献与文件夹按软件规则移入回收站）
  参数：文件夹编号
  
  
  
  
  
  

【题录操作类】

• noteexpress_save_refs
  功能：批量新建文献
  参数：文献信息列表（每条至少提供标题或 DOI）
• noteexpress_update_refs
  功能：批量更新已有文献字段
  参数：refs 数组（每项含 uid 与要更新的字段）
• noteexpress_smart_update_refs
  功能：对已有文献执行智能更新（在线元数据刷新）
  参数：文献 UID 列表；可选等待超时参数
• noteexpress_delete_refs
  功能：批量删除文献（移入回收站）；也可仅从指定文件夹解除链接
  参数：文献 UID 列表（必填）；可选 from_category_id（省略/0/-3 为移入回收站，正整数为仅从该文件夹解除链接）
• noteexpress_dedupe_refs
  功能：查找重复文献并删除多余项（非合并）；默认仅预览
  参数：可选：扫描文件夹、匹配字段、保留策略（附件最多优先）；dry_run 默认 true（预览），false 时将非保留项移入回收站
• noteexpress_move_refs
  功能：将文献移动到另一个文件夹
  参数：文献列表、源文件夹、目标文件夹
• noteexpress_link_refs
  功能：将文献链接到文件夹（保留原有位置，相当于「添加到文件夹」）
  参数：文献列表、目标文件夹
• noteexpress_export_refs
  功能：导出文献为格式化文本
  参数：文献 UID 列表、格式（ris / bibtex / noteexpress）
  
  
  
  
  

【附件、导入与系统诊断类】

• noteexpress_attach_file
  功能：为文献添加本机附件
  参数：文献 UID、文件名（必填）；重名时可选择覆盖或重命名
• noteexpress_remove_attach
  功能：删除某条文献的指定附件
  参数：文献 UID、附件编号
• noteexpress_import_pdf_ref
  功能：将本机 PDF 导入为新文献
  参数：PDF 路径（必填）；可选填写 DOI
• noteexpress_import_formatted_refs
  功能：从格式化文本批量导入文献
  参数：格式：noteexpress / ris / bibtex / pubmed；content 或 file_path 二选一；最多 1000 条/次、16 MiB 上限；不去重
• noteexpress_extract_pdf_text
  功能：从本机 PDF 提取文字（便于 AI 阅读、摘要）
  参数：PDF 路径（必填）；可选限制页数或字数
• noteexpress_get_server_status
  功能：查看服务状态、当前用户、题录库信息
  参数：可选：指定题录库
• noteexpress_ping
  功能：检查 MCP 服务是否在线
• noteexpress_version
  功能：查看 NoteExpress 版本及 MCP 能力说明
  
  
  
  
  

当前限制与反馈

1.目前 MCP 暂不支持对笔记内容进行修改或写入操作。
2.功能需求征集，如果您有特定的工作流需求是目前工具无法实现的，欢迎随时向我们反馈！另外如果反馈有效的 Bug，我们将赠送 500万 Token。

aegeansupport

使用示例：PubMed 文献一键入库

NeClaw 能够全自动处理 PubMed 数据流。您只需提供 PMID，它即可完成从检索、导入到全文下载的全过程。

您可以这样对它说：

“请检索PMID：34759261，并且把它导入进当前打开的NoteExpress数据库的PubMed文件夹内，然后下载它的全文。”

自动执行流程：
1.通过 PubMed API 获取完整题录信息。
2.利用 MCP 协议将题录导入当前的 NoteExpress 数据库。
3.下载全文关联到的附件中。

aegeansupport

【示例】使用 NeClaw 实现 NoteExpress 多文献对比

NoteExpress目前仅有单篇文献辅助阅读，不支持多文献对比（青提学术有此功能），但可通过 NeClaw + MCP 轻松实现。

您可以这样对它说：
“读取 NE 数据库中《Enhanced protective immunity against SARS-CoV-2 elicited by a VSV vector expressing a chimeric spike protein》和《Comparative study of patients with and without SARS who fulfilled the WHO SARS case definition》文献的PDF，总结核心观点。最后从实验设计、主要结论、理论框架、创新贡献、局限性及前景等维度进行详细对比。”
️
自动执行流程
精准检索：在 NoteExpress 中搜索并确认两篇目标文献存在。
获取路径：提取两篇文献的详细信息及本地 PDF 文件路径。
内容解析：调用 ne-mcp__noteexpress_extract_pdf_text 工具提取文本。
智能对比：AI 自动分析全文，输出包含七大维度的深度对比报告。

aegeansupport

【示例】使用NeClaw实现NoteExpress文献自动综述草稿生成

您可以这样对它说：：
"读取NE中带有'待引用'标签的所有文献的题录和它PDF全文，帮我按照'背景-问题-方法'的逻辑梳理成一段可以直接放进综述里的草稿，然后导出成word文档，放进我桌面的'写作'文件夹中。"

自动执行流程：
智能识别：精准定位NoteExpress中所有带有"待引用"标签的文献
全文提取：自动获取文献题录信息和PDF全文内容
智能梳理：按照"背景-问题-方法"的学术逻辑框架，自动生成结构化综述草稿
文档导出：将生成的综述草稿自动保存为Word文档，并放置在指定的"写作"文件夹中

aegeansupport

【示例】用 NeClaw 定时任务实现 NoteExpress 每日自动复盘


「定时任务」功能相当于为您雇佣了一位全天候待命的私人助理。您只需配置一次，它就会在每天固定时间主动去检查您的数据库，并将结果推送到您的 QQ，完全无需人工干预。（目前支持QQ、飞书。微信暂不支持）

您可以这样配置（填入 Agent 消息框）：
"请检查 NoteExpress 数据库，统计一下今天是否有新导入的文献？
如果有：请夸奖我，并告诉我今天增加了多少篇，主要集中在什么方向。
如果没有：请严厉地催促我，并给我讲一个因为拖延导致科研失败的悲惨小故事来警醒我。"



自动执行流程：
定时触发
系统会在您设定的时间（例如每天下午 17:00）自动唤醒 Agent，不需要您打开电脑或发送任何指令。


自主核查
Agent 自动静默连接 NoteExpress 数据库，扫描当天的文献增量情况。


逻辑判断
若检测到新增：自动生成统计报表，给予正向反馈。
若检测到零新增：触发“警示模式”，调用故事库进行心理干预。


消息推送
分析结果直接发到您的 QQ 上，让您每天能掌握自己的科研进度。

aegeansupport

【示例】用 NeClaw 实现 脑图生成

请阅读这篇文献的全文，按照 [研究背景] -> [核心问题] -> [研究方法] -> [关键数据/证据] -> [结论与贡献] 的逻辑生成脑图