几乎不
使用备份文件（.bear2bk）的熊笔记MCP服务器。
运作原理
- 从Bear导出：文件>备份笔记
- 加载备份：
load_backup工具 - 通过MCP工具进行更改
- 保存更改：
save_backup工具 - 导入到熊：文件>导入注释
注意：导入会创建重复项。首先删除旧笔记以进行干净导入。
需求
- 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许可证
麻省理工学院