用途
my-bear-mcp-server 是一个 Model Context Protocol(MCP)服务器,用于让 AI 助手(如 Claude)读取 Bear 笔记应用中的笔记内容。它直接连接 Bear 的 SQLite 数据库,并采用只读模式,保证笔记数据不被修改。
主要能力
该服务器提供以下只读工具,所有操作均为非破坏性,无法修改 Bear 数据库:
- 按标题或 ID 打开笔记。
- 按关键词或标签搜索笔记。
- 获取 Bear 中的所有标签。
- 显示带有特定标签的所有笔记。
使用方式
安装
有两种安装方式:
- 从 GitHub 安装(推荐):安装后服务器将启动并连接 Bear 数据库。
- 克隆并在本地运行。
环境要求
- 安装了 Bear 应用的 macOS。
- Node.js 18 或更高版本。
配置
- 对于 Claude 桌面应用,将配置添加到
~/Library/Application Support/Claude/claude_desktop_config.json。 - 对于 Claude VS Code 扩展,将配置添加到
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json。
交互示例
可以通过 AI 助手使用以下方式与 Bear MCP 工具交互:
- 搜索包含特定关键词的笔记。
- 按标题检索特定笔记。
- 列出所有 Bear 标签。
- 显示带有特定标签的笔记。
高级选项
如果 Bear 数据库位于非标准位置,可以进行相应配置。
适用场景
适用于希望让 AI 助手读取和检索 Bear 笔记内容的 macOS 用户,例如在 Claude 中搜索笔记、按标签查找笔记等。
限制
- 仅支持 macOS 且需安装 Bear 应用。
- 需要 Node.js 18 或更高版本。
- 所有操作均为只读,无法通过该服务器修改、删除或损坏笔记和标签。
- 数据库连接在驱动层面强制只读,若尝试写入权限将导致连接失败。
- 所有操作均为 SELECT 查询,仅检索数据而不修改。
许可
本项目采用 MIT 许可证,详见 LICENSE 文件。