better bear

better-bear MCP server

Build Release npm License: MIT better-bear MCP server Buy Me A Coffee

通过 CloudKit 为 Bear 笔记提供 MCP 服务器和 CLI。包含一个上下文库——这是一个经过整理、同步的笔记文件夹，针对 LLM 使用进行了优化，灵感来源于 Karpathy 的 LLM 知识库模式。

安装

安装 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：“Set up a context library”（设置一个上下文库）——它会通过 MCP 工具处理所有事情。

该架构遵循 Karpathy 的三文件夹模式：bear/（从 CloudKit 同步）、external/（PDF、导出文件、共享文档）和 inbox/（用于分类的暂存区）。一个 index.md 清单映射了所有内容。请参阅 better-bear.com 获取完整文档。