better-bear

Name: better-bear
Author: mreider

本地服务

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

代码仓库

关于 better-bear

better-bear 是面向 Bear 笔记的 MCP 服务和命令行工具，通过 CloudKit 读取、搜索、创建、编辑和标记笔记。它还提供一个经过整理、同步的上下文库，便于 LLM 按索引查找所需内容。

主要功能

01通过 CloudKit 访问 Bear 笔记
02笔记的读取、搜索、创建与编辑
03标签与附件管理
04基于 #context 标签的上下文库同步
05bcli 命令行工具与健康检查

适用场景

01让 Claude 检索和整理 Bear 笔记
02将部分笔记同步为供 LLM 使用的上下文文件夹
03通过命令行批量查看或追加笔记内容

MCP 相关

作为 MCP 服务，向 Claude Desktop 和 Claude Code 等 MCP 客户端提供 34 个工具，涵盖笔记、标签、TODO、附件、搜索和上下文库。

配置

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

mcp.json · 通用配置

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

启动命令npx -y better-bear

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

安装包

npmbetter-bear0.4.21stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

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。