better-bear

Name: better-bear
Author: KuvopLLC

本地服务

github.com/KuvopLLC生产力6827 周前更新

代码仓库

关于 better-bear

better-bear 是用于 Bear 笔记的 MCP 服务和命令行工具，通过 CloudKit 读写笔记。适合希望让 Claude 访问 Bear 笔记的用户。

主要功能

01通过 CloudKit 访问 Bear 笔记
0234 个 MCP 工具
03笔记搜索、创建与编辑
04标签与附件管理
05上下文库同步

适用场景

01让 Claude 搜索和整理 Bear 笔记
02将带 #context 标签的笔记同步为上下文文件夹
03在命令行中批量管理笔记

MCP 相关

better-bear 以 MCP 服务的形式向 Claude Desktop 和 Claude Code 提供 34 个工具，涵盖笔记、标签、待办、附件和上下文库。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "kuvopllc-better-bear": {
      "command": "npx",
      "args": [
        "-y",
        "better-bear"
      ]
    }
  }
}

启动命令npx -y better-bear

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmbetter-bear0.4.26stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
tag	string	否	按标签筛选笔记（部分匹配）
limit	number	否	要返回的笔记数量上限（默认值为 30）
include_trashed	boolean	否	在结果中包含已移至废纸篓的笔记
include_archived	boolean	否	在结果中包含已归档笔记

详细介绍

better bear

通过 CloudKit 使用 Bear 笔记的 MCP 服务和 CLI。包含一个上下文库——一个经过整理并同步的笔记文件夹，针对大模型读取进行了优化，灵感来自 Karpathy 的大模型知识库模式。

完整文档：better-bear.com

安装

安装 CLI，然后连接到 Claude：

curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install

此操作会安装 bcli 二进制文件，使用 iCloud 进行身份验证，并为 Claude Desktop（通过 .mcpb 包）和 Claude Code 配置 MCP 服务。

其他安装方式

方式	命令
仅 Claude Desktop	`bcli mcp install --desktop-only`
仅 Claude Code	`bcli mcp install --code-only`
Claude Code（直接安装）	`claude mcp add better-bear -- npx -y better-bear`
配置文件	`bcli mcp install --json`
.mcpb 包	从最新版本下载并双击

管理

bcli mcp status      # check what's configured
bcli mcp uninstall   # remove from Claude Desktop and Claude Code
bcli mcp reinstall   # clean uninstall + install
bcli upgrade         # upgrade bcli binary

CLI

所有命令也可以在终端中独立运行：

bcli ls                          # list notes
bcli search "query"              # full-text search
bcli create "Title" -b "Body"    # create a note
bcli edit <id> --append "text"   # append to a note
bcli tags                        # list all tags
bcli attach <id> photo.jpg       # attach a file
bcli stats                       # library statistics
bcli health                      # health check

完整命令参考请参阅 better-bear.com。

上下文库

将 Bear 笔记中的部分内容转换为经过整理并同步的上下文文件夹，让 Claude 使用优先查阅索引的方式进行检索。在 Bear 中为笔记添加 #context 标签并进行同步，Claude 会读取精简索引来查找相关文件——只加载所需内容，而不是全部加载。

bcli context init                          # one-time setup
bcli context sync                          # pull qualifying notes
bcli context add <id> --subtag research    # tag a note for inclusion
bcli context status                        # health check

或者告诉 Claude：“设置上下文库”——它会通过 MCP 工具处理所有事项。

此架构遵循 Karpathy 的三文件夹模式：bear/（从 CloudKit 同步）、external/（PDF、导出文件、共享文档）和 inbox/（待分类内容的投放区）。index.md 清单会索引所有内容。完整文档请参阅 better-bear.com。