Bear笔记读取服务

一个为LLMs提供快速、只读访问Bear笔记的服务器,通过直接读取SQLite数据库实现。

  • by mark-liu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mark-liu/bear-mcp

使用说明

熊mcp

MCP服务器,通过直接读取SQLite数据库,让LLM快速、只读地访问您的Bear笔记。

运作原理

Bear将笔记存储在磁盘上的Core Data SQLite文件中。此服务器以只读方式打开它(?mode=ro)并直接查询。无网络调用,无CloudKit同步延迟,无API密钥。对标签索引进行查询,而不是扫描笔记内容。

为什么存在

现有的Bear MCP选项要么通过Bear的x-callback-url方案(速度慢,需要Bear运行,macOS UI自动化),要么通过使用字符串连接构建SQL的akseyh实现。我想要一个设计上快速、只读、没有SQL注入问题的东西。

限制:

  • 仅限macOS --Bear是macOS/iOS应用程序,SQLite文件存在于macOS上
  • 只读 --此服务器无法创建、编辑或删除笔记
  • 需要全磁盘访问 --读取Bear数据库的过程需要在“系统设置”>“隐私与安全”中获得美国食品药品监督管理局的授权

安装

pip install bear-mcp

或者在不安装的情况下运行:

uvx bear-mcp

在Claude代码中配置

claude mcp add bear -s user -- uvx bear-mcp

工具

工具 说明
search_bear_notes 按文本和/或标签搜索笔记(使用标签索引,而不是文本扫描)
get_bear_note 通过UUID获取特定注释
list_bear_tags 列出所有标签(直接读取ZSFNOTETAG表)
find_notes_by_title 按标题查找笔记,精确或部分匹配
get_recent_notes 获取最近N天内修改的笔记

许可证

麻省理工学院