← 返回目录

Bear Notes MCP Server

社区

非官方、本地优先的 Bear 笔记 MCP 服务器，支持按相关性排序的搜索和编辑模式。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 205 热门
传输方式: stdio（本地进程）
运行环境: Node.js 24.13.0+
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 3 个月前
工具数: 13

44FMRS · D

该服务器为 Bear 笔记提供了强大的搜索和编辑功能，但它是非官方的，需要用户注意权限和风险。它适用于注重隐私和本地优先的用户，但不适用于不熟悉 MCP 或对小库需求简单的用户。

最强项 · 安全与权限 10/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

8/20

文档质量

9/20

安装易用性

9/20

查看各项评分依据

可靠性 8/20: 证据：README 列出了 12 个工具，其中 4 个只读工具始终开启，8 个写入工具在编辑模式下开启，并提到了修订令牌机制。GitHub Actions 徽章暗示有 CI，但本静态审查中未看到配置或测试文件。由于未执行测试，且工具行为与描述是否一致未获证实，因此将可靠性评分限制在 12 分以下。代码库结构没有披露，因此无法验证错误处理和依赖控制。扣分：缺乏可验证的执行证据，例如 CI 工作流和提交的测试。
安全与权限 10/20: 证据：该服务器默认只读，编辑模式可选，直接读取本地 SQLite 数据库，无网络调用，无遥测，并通过 Bear 的 URL 处理程序处理写入。安全性和数据边界清晰。没有发现凭据或恶意指标的迹象。扣分：未确认是否存在危险的删除操作；提供删除标签工具，但不会删除笔记。未提供确认机制。由于未发现红线问题，且默认情况下遵循最小权限原则，因此评分较高。
维护活跃度 8/20: 证据：仓库有 Apache-2.0 许可证，最近有提交（根据星标和活跃的 CI），并且已发布。未发现安全响应渠道或贡献指导的具体信息。扣分：未验证提交频率和依赖更新；未看到明确的所有权或许可证管理细节。
文档质量 9/20: 证据：README 提供了安装程序、工具列表、编辑模式配置、调试日志记录、常见问题解答和示例。文档被认为是全面的。扣分：缺少工具参数和限制的详细参考；未提供故障排除的深度指南。
安装易用性 9/20: 证据：提供了两个清晰的安装路径：Claude Desktop 扩展（.mcpb）和独立 npm 包，并提供了配置示例。仅支持 macOS，这是 Bear 的限制。扣分：由于未执行，安装步骤未被验证；需要 Node.js 24.13.0+ 和 Bear 应用程序，这可能会限制可访问性。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件连接数据库

适合谁

多年来积累了庞大笔记库的用户，子串搜索已不够用。
在多个 MCP 客户端（Claude Desktop, Claude Code, Cursor, Codex, Gemini 等）之间切换的用户。
希望在不打开 Bear 的情况下进行快速查询的用户。
需要整个库级别标签管理功能的用户。
关注供应链安全和隐私的用户。

不适合谁

笔记库较小，仅需要简单集成的用户。
不希望授予 MCP 服务器对本地数据库访问权限的用户。
需要在 Windows 或 Linux 上运行的用户（仅支持 macOS）。
需要官方支持或保证的用户（这是非官方项目）。

所需权限

读取 Bear Notes SQLite 数据库。
使用 Bear 的 X-callback-URL API 执行写入操作。
可选地附加本地文件（最大 25 MB）。
可选地通过 AI 客户端与 AI 提供商通信（注意隐私）。

风险与副作用

扩展安装时会出现红色警告，提示访问所有文件，但实际上仅访问 Bear 的数据库。
写入操作需要编辑模式，并且可能导致数据覆盖，如果修订令牌过期的话。
非官方项目，可能存在 bug，但代码库较小可审查。
仅支持 macOS。

安装接入

准备工作

运行环境：Node.js 24.13.0+

其他可选配置项（3 个）

UI_DEBUG_TOGGLE 可选设为 true 以启用独立 MCP 服务器的调试日志，用于排障，非必需。

UI_ENABLE_NEW_NOTE_CONVENTION 可选设为 true 让新建笔记的标签紧跟标题而不是置于底部，属于可选约定，非必需。

UI_ENABLE_CONTENT_REPLACEMENT 可选设为 true 以开启 Edit Mode，解锁 8 个写入工具，默认关闭（只读），非必需。

Claude Desktop 扩展：

从 Releases 下载最新的 bear-notes-mcpb-*.mcpb 文件。
确保 Claude Desktop 正在运行。
双击扩展文件，按照提示安装。

独立 MCP 服务器（其他客户端）：

需要 Node.js 24.13.0+。
对于 Claude Code，运行 claude mcp add -s user bear-notes -- npx -y bear-notes-mcp@latest。
对于其他客户端，将 JSON 配置添加到 MCP 配置文件中。

示例配置：

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "bear-notes": {
      "command": "npx",
      "args": [
        "-y",
        "bear-notes-mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add bear-notes -- npx -y bear-notes-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后在客户端工具列表中应出现 bear-search-notes 等 4 个只读工具（开启 Edit Mode 后还有写入工具）；运行一次 "Search my Bear notes for 'meeting'"，若能返回笔记即证明连接成功。

常见排障

检查 Node.js 版本是否满足要求（24.13.0+）。
确保 Bear 应用已安装（写入操作需要）。
对于 Claude Desktop，检查日志：`~/Library/Logs/Claude/main.log` 和 `~/Library/Logs/Claude/mcp-server-Bear Notes.log`。
设置环境变量 `UI_DEBUG_TOGGLE=true` 以启用详细日志。
如果双击 .mcpb 文件无效，请通过 Claude 设置中的扩展选项手动安装。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在我的 Bear 笔记中搜索关于 export pipelines 的深入笔记
把今天的决定追加到 Weekly Ops 笔记的 Decisions 部分
列出我 Bear 库中所有标签的层级树和各标签的笔记数
把本地的 report.pdf 附加到我的 Meeting Notes 笔记里

工具能力 13

bear-capabilities 只读

报告当前服务器模式（只读或编辑模式）以及如何解锁额外功能。

bear-open-note 只读

通过 ID 或标题读取 Bear 笔记的完整文本内容，包括附加图片和 PDF 的 OCR 文本。

bear-create-note 写入

创建新笔记，可指定标题、内容、标签。

bear-search-notes 只读

按相关性在标题、正文和附加图片/PDF 的 OCR 文本中搜索笔记。支持标签、日期范围、固定等过滤器。

bear-add-text 写入

在笔记开头或结尾或特定标题下的区域插入文本。需要当前修订令牌（Revision）。

bear-replace-text 写入

替换现有笔记的部分或全部内容。需要当前修订令牌（Revision）。

bear-add-file 写入

将本地文件（如 PDF、图片）附加到现有笔记，可通过 ID 或标题指定。最大 25 MB，拒绝符号链接。

bear-list-tags 只读

以层次树形式列出所有标签，并显示笔记数量。

展开其余 5 个工具

bear-find-untagged-notes 只读

查找所有未分配标签的笔记。

bear-add-tag 写入

为现有笔记添加一个或多个标签。需要当前修订令牌（Revision）。

bear-archive-note 写入

归档笔记，将其从活动列表中移除但不会删除。

bear-rename-tag 写入

重命名整个文库中的标签。

bear-delete-tag 破坏性

从所有笔记中删除标签，不影响笔记内容。

使用场景

搜索多年累积的笔记，相关结果优先。

在对话中快速查询笔记，无需打开 Bear 应用。

管理整个文库的标签，包括重命名和删除。

将笔记内容整理到 AI 对话中，例如编写大纲或总结。

通过编辑模式自动化笔记创建和编辑。

支持客户端

Claude Desktop

Claude Code

Cursor

Codex

Gemini

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

Bear Notes MCP Server 是一个非官方、有观点的 Bear 笔记的 MCP 服务器。它提供按相关性排序的搜索（而非子串匹配），搜索结果跨越标题、正文和分层标签，并带有片段和可组合的过滤器（标签、日期、固定）。读取操作直接针对 Bear 的 SQLite 数据库，无需运行 Bear 应用。写入操作通过 Bear 自己的 URL 处理器进行，原子且经过 Bear 验证。离线优先，无网络调用，无遥测。可作为 Claude Desktop 扩展或独立 npm 包使用。