使用说明
熊mcp
MCP服务器,使克劳德可以通过以下方式直接访问您的Bear笔记 better-bear-cli (bcli).
bcli 通过CloudKit与Bear通信(Bear Web使用的路径相同),因此可以安全地与Bear一起运行,而无需接触本地SQLite数据库。
先决条件
-
更好的熊cli 已安装并验证:
brew install bcli # or however you install it bcli auth # authenticate with Bear / iCloud -
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