Upnote Lens Mcp

upnote-lens-mcp

一个混合型 MCP 服务，让 AI 助手能够使用你的 UpNote 笔记：

• 🔍 查找与搜索：按关键词搜索标题和正文中的笔记。
• 📖 阅读与总结：它会返回笔记的实际文本，这样 AI 就能总结、分析或回答有关你所写内容的问题。
• ✍️ 创建：通过聊天创建新笔记。

其底层实现：读取内容来自本地 UpNote SQLite 数据库（只读），因此会以文本形式返回真实内容；写入则通过 upnote:// URL scheme（x-callback-url）完成，绝不会接触数据库。

写入功能（URL scheme）基于 chadthornton/upnote-mcp（MIT）。

使用方法

注册后，只需用自然语言与 AI 助手对话，它就会为你选择合适的工具。无需记忆任何命令或语法。例如：

• “总结我的 UpNote 笔记中关于 Q3 路线图的内容。”
• “查找提到 Postgres 调优的笔记，并提取要点。”
• “我上个月写了哪些关于入职引导的内容？”
• “显示我最近的 5 篇笔记。”
• “创建一篇标题为 ‘Standup 6/4’、内容包含今天三项优先事项的笔记。”

阅读、搜索、总结和创建都可以通过自然对话完成。

要求

• macOS：全面支持并已验证。
• Windows：尽力支持。URL 会通过已注册的 scheme handler 启动，默认数据库路径则猜测为 %APPDATA%\UpNote\ 下的路径。作者尚未验证此路径——如果读取失败，请设置 UPNOTE_LENS_DB（见下文）。
• Python 3.10+（或者直接使用 uv，它自带所需组件）。
• 已安装 UpNote 桌面应用。

安装与注册

🤖 让 AI 为你安装（最简单）

给你的 MCP 客户端（Claude 等）一个指向 llms-install.md 的链接，它就会运行安装步骤并完成所有设置。

🧑 自行安装

选择最适合你现有环境的第一个选项。每个选项都包含在 Claude 中注册的方法。

Claude Desktop 配置文件（各选项中提及）：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

选项 1 — 使用 uv（推荐）

需要先安装一次 uv （brew install uv，或 curl -LsSf https://astral.sh/uv/install.sh | sh）。 之后无需安装软件包——uvx 会按需下载、缓存并运行 upnote-lens-mcp。

Claude Code：

claude mcp add upnote-lens -- uvx upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }

选项 2 — 使用 pip（如果你没有 uv）

pip install upnote-lens-mcp

Claude Code：

claude mcp add upnote-lens -- upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }

选项 3 — 通过 HTTPS 从 GitHub 安装（如果你没有 pip）

如果无法使用 PyPI/pip，可以使用 uv 直接从仓库安装。（还没有 uv？ curl -LsSf https://astral.sh/uv/install.sh | sh。）

Claude Code：

claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }

工具

读取（查询本地数据库 → 返回真实文本）

工具	描述
search_notes(query, limit=20)	在标题和正文中进行子字符串搜索。返回 id、标题、更新时间和摘要
get_note(note_id, include_html=False)	返回笔记的完整标题和正文文本（可选返回原始 HTML）
list_recent(limit=20)	最近更新的笔记
list_notebooks()	返回笔记本及其笔记数量和父级信息
list_notes_in_notebook(notebook_id, limit=50)	笔记本中的笔记
list_tags()	返回标签及其笔记数量
list_notes_by_tag(tag_title, limit=50)	返回带有指定标签的笔记

写入（upnote:// URL scheme）

工具	描述
create_note(title, content, notebook?, markdown=True, new_window=False)	创建笔记。默认情况下，content 为 Markdown。notebook 按名称匹配。无法设置标签（见下文）
open_note(note_id, new_window=False)	在应用中打开现有笔记
open_notebook(notebook_id)	在应用中打开笔记本

标签限制：UpNote 的 note/new URL scheme 不支持标签参数，写在正文中的话题标签会保留为纯文本，而不会成为真正的标签（只有在编辑器中输入时才会转换为标签）。如果需要添加标签，请在创建笔记后在应用中手动添加。

覆盖数据库路径

如果数据库不在默认位置（或你使用的是 Windows），请通过环境变量指定路径：

UPNOTE_LENS_DB=/path/to/upnote.sqlite3

默认路径：

• macOS：~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3
• Windows（推测路径）：%APPDATA%\UpNote\upnote.sqlite3

许可证

MIT。详情请参阅 LICENSE。 写入端的 URL scheme 格式和启动方式改编自 chadthornton/upnote-mcp（MIT）。