适合谁
- 多年来积累了庞大笔记库的用户，子串搜索已不够用。
- 在多个 MCP 客户端（Claude Desktop, Claude Code, Cursor, Codex, Gemini 等）之间切换的用户。
- 希望在不打开 Bear 的情况下进行快速查询的用户。
- 需要整个库级别标签管理功能的用户。
- 关注供应链安全和隐私的用户。
B
44FMRS · D
该服务器为 Bear 笔记提供了强大的搜索和编辑功能，但它是非官方的，需要用户注意权限和风险。它适用于注重隐私和本地优先的用户，但不适用于不熟悉 MCP 或对小库需求简单的用户。
Bear Notes MCP Server 是一个非官方、有观点的 Bear 笔记的 MCP 服务器。它提供按相关性排序的搜索（而非子串匹配），搜索结果跨越标题、正文和分层标签，并带有片段和可组合的过滤器（标签、日期、固定）。读取操作直接针对 Bear 的 SQLite 数据库，无需运行 Bear 应用。写入操作通过 Bear 自己的 URL 处理器进行，原子且经过 Bear 验证。离线优先，无网络调用，无遥测。可作为 Claude Desktop 扩展或独立 npm 包使用。
工具能力
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
以层次树形式列出所有标签，并显示笔记数量。
bear-find-untagged-notes
查找所有未分配标签的笔记。
bear-add-tag
为现有笔记添加一个或多个标签。需要当前修订令牌（Revision）。
bear-archive-note
归档笔记，将其从活动列表中移除但不会删除。
bear-rename-tag
重命名整个文库中的标签。
bear-delete-tag
从所有笔记中删除标签，不影响笔记内容。
安装接入
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"]
}
}
}
选型与风险
不适合谁
- 笔记库较小，仅需要简单集成的用户。
- 不希望授予 MCP 服务器对本地数据库访问权限的用户。
- 需要在 Windows 或 Linux 上运行的用户（仅支持 macOS）。
- 需要官方支持或保证的用户（这是非官方项目）。
所需权限
- 读取 Bear Notes SQLite 数据库。
- 使用 Bear 的 X-callback-URL API 执行写入操作。
- 可选地附加本地文件（最大 25 MB）。
- 可选地通过 AI 客户端与 AI 提供商通信（注意隐私）。
风险与副作用
- 扩展安装时会出现红色警告，提示访问所有文件，但实际上仅访问 Bear 的数据库。
- 写入操作需要编辑模式，并且可能导致数据覆盖，如果修订令牌过期的话。
- 非官方项目，可能存在 bug，但代码库较小可审查。
- 仅支持 macOS。
常见排障
- 检查 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 设置中的扩展选项手动安装。
使用场景
搜索多年累积的笔记，相关结果优先。
在对话中快速查询笔记，无需打开 Bear 应用。
管理整个文库的标签，包括重命名和删除。
将笔记内容整理到 AI 对话中，例如编写大纲或总结。
通过编辑模式自动化笔记创建和编辑。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Codex完整支持
Gemini完整支持
Windsurf完整支持