Bear笔记访问工具

一个MCP服务器,通过better-bear-cli为Claude提供直接访问Bear笔记的功能,支持笔记的列表、获取、搜索、创建、编辑、删除和导出等操作。

  • by ntwkrgr
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ntwkrgr/bear-mcp

使用说明

熊mcp

MCP服务器,使克劳德可以通过以下方式直接访问您的Bear笔记 better-bear-cli (bcli).

bcli 通过CloudKit与Bear通信(Bear Web使用的路径相同),因此可以安全地与Bear一起运行,而无需接触本地SQLite数据库。


先决条件

  1. 更好的熊cli 已安装并验证:

    brew install bcli   # or however you install it
    bcli auth           # authenticate with Bear / iCloud
    
  2. Node.js 18+


设置

cd /path/to/bear-mcp
npm install
npm run build

然后注册 ~/.claude.json 在该项目下,您希望bear mcp在以下位置可用:

{
  "mcpServers": {
    "bear-mcp": {
      "command": "node",
      "args": ["/Users/you/Developer/MCP Servers/bear-mcp/dist/index.js"]
    }
  }
}

可用工具

工具 说明
bear_list_notes 列出笔记,可选择按标签过滤或包括已存档/已丢弃的笔记
bear_get_note 按ID获取笔记的全部内容
bear_list_tags 列出笔记中的所有标签
bear_search_notes 在笔记中进行全文搜索
bear_create_note 创建一个包含标题、正文和标签的新笔记
bear_edit_note 将文本附加到现有注释中
bear_trash_note 将便条移至垃圾箱
bear_export_notes 将笔记导出为Markdown文件到目录

环境变量

变量 默认值 用途
BEAR_BCLI_PATH PATH查找 覆盖路径 bcli 二进制
BEAR_MCP_LOG off 设置为 debug 启用stderr日志记录

发展

npm run dev    # TypeScript watch mode
npm run build  # Compile to dist/
npm start      # Run compiled server