AI导哈

Bear笔记备份管理工具

一个用于管理和操作Bear笔记备份文件的工具，支持备份加载、编辑和同步功能。

  • by mreider
  • Go
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 mreider/bearly

使用说明

几乎不

使用备份文件（.bear2bk）的熊笔记MCP服务器。

运作原理

  1. 从Bear导出：文件>备份笔记
  2. 加载备份： load_backup 工具
  3. 通过MCP工具进行更改
  4. 保存更改： save_backup 工具
  5. 导入到熊：文件>导入注释

注意：导入会创建重复项。首先删除旧笔记以进行干净导入。

需求

  • macOS
  • Bear应用程序
  • 转到1.21+（从源代码构建）

安装

快速安装

curl -fsSL https://raw.githubusercontent.com/mreider/bearly/main/install.sh | bash

运行后重新启动Claude Desktop。

手动安装

# Apple Silicon
curl -L https://github.com/mreider/bearly/releases/latest/download/bearly-darwin-arm64 -o bearly

# Intel Mac
curl -L https://github.com/mreider/bearly/releases/latest/download/bearly-darwin-amd64 -o bearly

chmod +x bearly

从源代码构建

git clone https://github.com/mreider/bearly.git
cd bearly
go build -o bearly ./cmd/bearly/

配置Claude桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bearly": {
      "command": "/path/to/bearly"
    }
  }
}

配置Claude代码

claude mcp add bearly /path/to/bearly

工具

会话

工具 说明
load_backup 加载.bear2bk文件
save_backup 将更改保存到.bear2bk
get_session_info 检查会话状态

阅读

工具 说明
list_notes 列出笔记（过滤器：固定、存档、丢弃）
open_note 按UUID或标题获取注释
search 搜索标题和内容
list_tags 列出带有计数的标签
get_notes_with_tag 带有特定标签的注释
get_untagged 无标签的笔记
get_stats 备份统计

写

工具 说明
create_note 创建注释
update_note 更新笔记内容
delete_note 删除注释
set_note_status 设置固定/存档/丢弃

标签

工具 说明
add_tag_to_note 将标签添加到注释中
remove_tag_from_note 从笔记中删除标签
rename_tag 重命名所有笔记中的标签
merge_tags 合并两个标签

清理

工具 说明
fix_untitled_notes 修复没有标题的笔记
strip_frontmatter 删除YAML frontmatter

Bear Sync（GUI自动化）

需要辅助功能权限（系统首选项>隐私和安全>辅助功能）。

工具 说明
sync_from_bear 从Bear导出并装载
sync_to_bear 保存并导入到Bear
export_from_bear 从Bear导出备份
import_to_bear 将备份导入Bear
check_accessibility 检查权限

熊直接（X-Callback-URL）

不需要权限。直接与Bear应用程序配合使用。

工具 说明
bear_create_note 在Bear中创建笔记
bear_add_text 在注释中添加文本
bear_rename_tag 重命名标签
bear_delete_tag 删除标签
bear_trash 废钞

黑曜石

工具 说明
list_obsidian_vaults 查找保险库
export_to_obsidian 出口到黑曜石
import_from_obsidian 从黑曜石进口

熊备份格式

.bear2bk文件是一个包含TextBundle文件夹的ZIP文件：

backup.bear2bk/
├── Note Title.textbundle/
│   ├── text.md      # Content
│   ├── info.json    # Metadata
│   └── assets/      # Attachments

许可证

麻省理工学院

相关 MCP