更好的熊mcp
MCP服务器，允许克劳德访问您的熊笔记。
由...驱动 更好的熊cli （bcli），它将贝尔斯登的票据操作暴露为stdio传输上的MCP工具。
先决条件
- macOS（Bear仅适用于macOS）
- 熊 安装时启用了iCloud同步
- Node.js 20+
- iCloud帐户（用于CloudKit身份验证）
安装
适用于Claude Desktop用户 --只需在下面添加配置即可。 npx 处理其余的。
发展：
git clone https://github.com/darronz/better-bear-mcp.git
cd better-bear-mcp
npm install
npm run build认证
Bear通过CloudKit在iCloud中存储笔记。要访问它们，bcli需要来自Apple登录的一次性CloudKit身份验证令牌。
设置
- 跑
bcli auth在终端中 - 打开Apple登录的浏览器窗口——使用您的iCloud帐户登录
- 完成后，终端显示“已成功验证”
- 令牌保存在
~/.config/bear-cli/auth.json并在会话中持续存在
替代方案：从Claude处进行身份验证
这 bear_auth MCP工具可以直接从Claude对话中触发身份验证。它在不离开聊天的情况下打开相同的浏览器流。
无头/SSH环境
如果您通过SSH运行（没有可用的浏览器），请直接使用令牌进行身份验证：
bcli auth --token ''令牌到期
如果Bear操作开始失败，出现“未通过身份验证”或“身份验证令牌过期”错误，请重新运行 bcli auth 或使用 bear_auth 工具。
Claude桌面设置
将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"better-bear": {
"command": "npx",
"args": ["-y", "better-bear-mcp"]
}
}
}编辑配置后重新启动Claude Desktop。
为了地方发展，直接使用构建的输出：
{
"mcpServers": {
"better-bear": {
"command": "node",
"args": ["/absolute/path/to/better-bear-mcp/dist/index.js"]
}
}
}可用工具
| 工具 | 说明 |
|---|---|
bear_get_note | 按ID检索笔记的全部内容 |
bear_list_notes | 列出带有可选标签过滤器和限制的注释 |
bear_search_notes | 按文本查询搜索笔记 |
bear_list_tags | 列出所有标签 |
bear_create_note | 创建一个包含标题、正文和标签的新笔记 |
bear_edit_note | 将文本附加到现有注释中 |
bear_trash_note | 软删除（垃圾）笔记 |
bear_export_notes | 将笔记导出为Markdown文件 |
bear_auth | 触发Apple登录身份验证 |
故障排除
“未通过身份验证”或“身份验证令牌已过期” 跑 bcli auth 在终端中或使用 bear_auth 工具。
Claude Desktop找不到服务器 检查Node.js是否在您的PATH中。这 npx 建议使用这种方法——它会自动处理安装。
“未找到bcli二进制文件” 跑 npm install 触发下载bcli的安装后脚本。
许可证
麻省理工学院