用途
这是一个面向 Bear 笔记应用的非官方、带有特定设计取向的 MCP 服务器，目标是让 AI 助手能够搜索、读取、创建和更新本地的 Bear 笔记。它既可以作为 Claude Desktop 的一键扩展安装，也可以作为独立 npm 包供任何支持 MCP 的客户端使用（如 Claude Code、Codex、Gemini、Cursor、Windsurf）。
主要能力
- 相关度排序搜索：搜索不局限于字面子串匹配，会跨标题、正文和层级标签对结果进行相关度排序，并附带上下文片段，支持标签、日期范围、仅置顶等可组合过滤器。
- 直接读取：读取操作直接访问 Bear 的 SQLite 数据库，查询时无需打开或运行 Bear 应用。
- 原生写入：写入通过 Bear 自身的 URL handler 完成，具备原子性并由 Bear 校验。
- 日期搜索：支持相对日期，例如“昨天”“上周”“上月初”。
- 层级标签管理：可将标签以树状结构查看并附带笔记数量，支持跨整个笔记库重命名或删除标签。
- 精细写入：可在指定标题处追加内容，或替换某个章节，而无需重写整篇笔记。
- 文件附件：可附加图片、PDF 和文档，大小上限为 25 MB；出于安全考虑拒绝符号链接。
- 本地优先与隐私：无网络调用、无遥测，所有处理在本地 Mac 上完成，使用原生 node:sqlite，不依赖第三方二进制。
使用方式
Claude Desktop 扩展
前置条件：已安装 Bear 应用和 Claude Desktop。从 Releases 下载最新的 bear-notes-mcpb-*.mcpb 扩展文件，确保 Claude Desktop 正在运行，双击该文件后 Claude Desktop 应显示安装提示。如果双击无效，可打开 Claude → Settings → Extensions → Advanced Settings → 点击“Install Extension”。之后可以要求 Claude 搜索 Bear 笔记，例如“Search my Bear notes for 'meeting'”。
独立 MCP 服务器
需要 Node.js 24.13.0+，将服务器加入 MCP 配置文件即可。更完整的安装选项与本地开发设置见 NPM.md。
可用工具
服务器提供以下工具：
bear-open-note：按 ID 或标题读取 Bear 笔记全文，包括附件图片和 PDF 的 OCR 文本。bear-create-note：创建新笔记，可选标题、内容和标签。bear-search-notes：按相关度跨标题、正文及附件 OCR 文本查找笔记，支持标签、日期范围、仅置顶过滤。bear-add-text：在笔记开头、结尾或指定标题章节内插入文本，需要当前修订令牌。bear-replace-text：替换笔记正文或特定章节内容，需要当前修订令牌。bear-add-file：将本地文件（图片、PDF、文档）附加到笔记，Bear 会通过 OCR 提取文本使其可搜索，需要当前修订令牌。bear-list-tags：以层级树形式列出所有标签及笔记数量。bear-find-untagged-notes：查找没有标签的笔记。bear-add-tag：为笔记添加一个或多个标签，需要当前修订令牌。bear-archive-note：归档笔记，使其从活动列表移除但不删除。bear-rename-tag：跨整个笔记库重命名标签。bear-delete-tag：从所有笔记中删除标签而不影响笔记本身。bear-capabilities：报告当前服务器模式（只读或编辑模式）以及如何解锁更多能力。
注意：写入类工具要求传入笔记当前的修订令牌（即上一次响应中引用的 Revision: N 行），使用过期的修订会被拒绝，并提示先用 bear-open-note 重新读取后再重试。
配置
- 详细日志：Claude Desktop 中在 Settings → Extensions → Configure → 切换“Debug Logging”；独立服务器设置环境变量
UI_DEBUG_TOGGLE=true。 - 新笔记约定：默认 Bear 通过 API 创建笔记时把标签放在底部，可启用该选项将标签放在标题之后（以分隔线隔开）。Claude Desktop 在 Configure 中切换“New Note Convention”；独立服务器设置
UI_ENABLE_NEW_NOTE_CONVENTION=true。 - 编辑模式：默认关闭，关闭时服务器完全只读，
tools/list仅返回 4 个读取工具（bear-open-note、bear-search-notes、bear-find-untagged-notes、bear-list-tags）加bear-capabilities。开启后解锁全部 8 个写入工具。Claude Desktop 在 Configure 中切换“Edit Mode”；独立服务器设置UI_ENABLE_CONTENT_REPLACEMENT=true。
适用场景
- 笔记量很大，字面子串搜索已不够用，需要按相关度找到正确笔记。
- 在多个 MCP 客户端之间切换，希望使用统一的 stdio 传输、无需为每个客户端写胶水代码。
- 希望在对话中快速查询笔记而不必把 Bear 拉到前台，甚至无需运行 Bear。
- 需要跨整个笔记库重命名或删除标签，而通过 Bear 界面操作较为繁琐。
- 关注供应链安全，偏好原生 node:sqlite、无网络、无远程抓取工具的服务器。
限制
- 仅支持 macOS，因为 Bear 桌面版仅运行于 macOS。
- 非官方项目，作者称其为“有主见的替代方案”。
- 读取直接访问 SQLite，写入仍通过 Bear 完成。
- 附件大小上限 25 MB，不接受符号链接。
- 写入需要修订令牌，过期修订会被拒绝。
- 使用 AI 助手时，发送给 AI 提供商的数据仍会离开本地，这一点不在服务器控制范围内。
- 安装扩展时 Claude for Desktop 可能显示“将授予访问计算机上所有内容”的红色警告，这是 Claude 警告系统无法区分仅访问单个文件与访问全部文件所致；扩展实际只访问 Bear 的本地数据库。
- 详细日志、独立安装、NPM.md 中更完整的选项以及本地开发设置等具体内容请参阅项目仓库；资料未提供其他收费、价格或平台信息。