bookmarks-mcp

bookmarks-mcp

无论书签存在哪里，你的 AI 都能读取。

每个人都会保存书签。浏览器、稍后阅读应用、2023 年导出的 Pocket 文件—— 保存已经不是问题。处理才是：普通书签保存一次后就再也不会被打开。AI 助手是第一个 真正能处理这类书签堆的工具——可以总结、分类、整理成待办事项列表——但它们看不到这些书签。

这是一个本地只读 MCP 服务，专门解决“看不到”的问题。

One command in your MCP client config. Zero accounts. Nothing is ever sent to us.

数据来源

来源	方式	备注
Chrome、Edge、Brave、Arc、Vivaldi、Chromium	读取各配置文件中的本地 Bookmarks 文件	自动检测所有配置文件
Safari（macOS）	读取 ~/Library/Safari/Bookmarks.plist	包含你的阅读列表；任何扩展都无法做到这一点——Safari 的扩展 API 不提供书签接口
Firefox	读取各配置文件中的 places.sqlite	需要 Node ≥ 22.5（内置 sqlite）；低于此版本时会优雅降级
导出文件	Pocket CSV、Instapaper CSV、Raindrop CSV、浏览器 HTML、URL 列表	通过 parse-bookmarks

手机书签：同步到桌面后即可访问（iCloud → Mac 上的 Safari，Chrome 同步 → 桌面配置文件）。没有任何第三方工具能直接读取 iOS 上的 Safari 书签。

安装

无需账户、API 密钥或配置——安装后即可运行服务。

Claude Code：

claude mcp add -s user bookmarks -- npx -y bookmarks-mcp

请使用 -s user。 作用域默认为 local，只会为你运行命令的目录注册服务。你的书签并不属于某个特定项目，因此应将服务注册到整个账户。

Claude Desktop / Cursor / 任何 MCP 客户端（mcpServers JSON）：

{
  "mcpServers": {
    "bookmarks": {
      "command": "npx",
      "args": ["-y", "bookmarks-mcp"]
    }
  }
}

如需从源代码运行（用于开发），请将此仓库克隆到其依赖项 parse-bookmarks 旁边（两个目录必须是同级目录），在 bookmarks-mcp 中运行 npm install，并将客户端指向 node /absolute/path/to/bookmarks-mcp/src/index.js。

macOS + Safari：托管服务的应用（Claude Desktop、你的终端）需要完全磁盘访问权限（系统设置 → 隐私与安全性），因为 ~/Library/Safari 受保护。Chromium 浏览器和 Firefox 无需任何权限。

工具

工具	功能
list_sources	列出在此设备上找到的所有书签来源
list_bookmarks	列出书签，支持按文件夹筛选和分页
search_bookmarks	搜索标题 / URL / 文件夹 / 标签
recent_bookmarks	“我这周保存了什么？”
bookmark_stats	书签堆的情况：数量、年龄分布、热门域名
parse_export_file	解析磁盘上的 Pocket/Instapaper/Raindrop/HTML 导出文件
export_bookmarks	将所有书签导出为 Markdown、CSV、JSON 或可导入的浏览器 HTML
fetch_page_preview	获取页面的数百个 Token 预览（标题、描述、标题层级、摘录），而非原始 HTML——当标题 / URL 本身不足以进行分类时使用

将书签堆整理成待办事项列表

这正是这个项目存在的原因。向你的助手提问：

查看我的书签统计数据，然后帮我分类：哪些值得深入阅读，哪些是值得尝试的工具，哪些与我正在做的项目有关，哪些我该终于放手？请为我列出本周的检查清单。

或者使用内置的 triage_bookmarks 提示词，它会带你逐步完成这些工作——包括询问你通常会如何处理保存的书签，让分类方式由你决定，而不是由我们决定。

保证

• 只读。 此服务绝不会写入浏览器文件。它没有删除工具，书签不会受到损害。
• 绝不向外发送数据。 无遥测、无账户，也不会向我们发送哪怕一个字节。服务只会连接两个地方：你的本地书签文件，以及——仅当你要求预览页面时——通过你的设备直接连接书签对应的网站。
• 输出干净。 工具结果就是数据。绝无广告或推销。

设计边界

这些是有意设定的边界，并非等待填补的空白。跨越这些边界的 PR 将被拒绝：

• 仅提取预览级内容。 fetch_page_preview 回答的是“这值得我花时间吗？”——它不是阅读模式，也永远不会成为高保真内容提取器。
• 仅限公开网页。 不使用代理，不处理登录墙，也不针对 X/YouTube/WeChat 等进行特殊处理。如果页面需要身份验证才能阅读，这个工具就不是访问入口。
• 仅按需执行。 绝不会在后台抓取任何内容。每次网络调用都直接响应你发起的工具调用。

路线图

• 使用用户提供的令牌访问云端来源（Raindrop、Readwise 等）——每项服务对应一个适配器。欢迎提交 PR；适配器是一个定义明确的单文件。
• 已经提供自有 MCP 服务的服务不需要我们——同时运行这两个服务，你的助手就能看到所有内容。我们只覆盖没有其他桥接方式的地方。

关于我们

由 Burn 451 团队打造。Burn 451 是一款稍后阅读应用。这个服务特意保持中立：它会读取你的书签，供你选择的任意助手和工作流使用，并且绝不会写入书签。

许可证

MIT