Bear MCP服务器
用于将Bear笔记应用程序与Claude Desktop集成的MCP（模型上下文协议）服务器。此服务器允许Claude直接阅读、创建和搜索您的Bear笔记。
✨ 功能（v4.0.2）
完整的数据检索功能：
- 🔍 搜索笔记 并使用元数据获得完整的结果
- 🏷️ 检索所有标签 从您的Bear数据库
- 📖 阅读笔记内容 用于分析和总结
- ✏️ 创建笔记 并取回他们的身份证
- 📝 添加文本 到现有笔记
- ✅ 测试设置 具有全面的状态检查功能
⚠️ 当前限制和使用指南
浏览器窗口行为
预期：由于Bear的回调系统，在搜索/标记操作期间可能会出现简短的浏览器窗口。
- Windows会自动最小化并移出屏幕
- 在大多数情况下，1-2秒内自动关闭
- 手动关闭安全 如果他们坚持
- 焦点已恢复 自动转到原始窗口
搜索可靠性
成功率：约80-90%的搜索工作可靠
- 偶尔超时 可能发生（20秒限制）
- 简单术语 比复杂的查询工作得更好
- 重试一次 如果搜索超时
- 单词 往往比短语更可靠
最佳实践
✅ 推荐使用方法:
Search my Bear notes for "project"
Get all my Bear tags
Create a note titled "Meeting Notes" with today's agenda
Add "Action item: Follow up" to my "Weekly Review" note⚠️ 如果出现问题:
- 超时：请稍等，然后重试相同的搜索
- 浏览器窗口：如果它们不能自动关闭，可以安全地手动关闭
- 没有结果：尝试使用更简单/更广泛的搜索词
- 安装问题：使用
check_bear_setup诊断
可用工具
| 工具 | 功能 | 可靠性 | 注意事项 |
|---|---|---|---|
create_note | 创建新笔记 | ✅ 优秀 | 始终有效，返回ID |
add_text | 在笔记中添加文本 | ✅ 优秀 | 可靠的文本添加 |
check_bear_setup | 测试配置 | ✅ 优秀 | 诊断工具 |
search_notes | 搜索笔记 | ⚠️ 好 | ~80-90%成功，可能超时 |
get_tags | 列出所有标签 | ⚠️ 好 | 通常有效，短暂弹出 |
get_note | 检索笔记内容 | ⚠️ 良好 | 与有效ID配合使用效果良好 |
安装
- 克隆存储库：
git clone https://github.com/philgetzen/bear-mcp.git
cd bear-mcp- 安装依赖项：
npm install- 构建项目：
npm run buildClaude桌面中的配置
将服务器添加到Claude Desktop配置文件中：
macOS
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bear": {
"command": "node",
"args": ["/path/to/bear-mcp/dist/index.js"]
}
}
}视窗
编辑 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"bear": {
"command": "node",
"args": ["C:\\path\\to\\bear-mcp\\dist\\index.js"]
}
}
}熊配置
所需设置：
- 启用x-callback-url:
- 打开熊→ 设置（⌘，） - 转到“高级”选项卡 - 启用“允许x-callback-url”
- 生成API令牌 （用于搜索和标签）：
- 打开熊→ Help → 高级→ API代币 - 点击“复制令牌” - 在Claude中，使用： set_bear_token 用你的代币
使用示例
设置和测试
Check my Bear setup and show me what's available可靠运行（始终工作）
Create a new Bear note titled "Project Ideas" with content about machine learning
Add "## Next Steps\n- Review documentation\n- Schedule follow-up" to my "Weekly Review" note搜索操作（通常有效）
Search my Bear notes for "machine learning" and show me what you find
Get all my Bear tags and help me organize them内容分析（搜索有效时）
Search for "meeting notes" then help me identify common action items across all results
Find notes tagged with "work" and summarize the main topics故障排除
“搜索失败：回调超时”
- 正常：发生率约为10-20%
- 解决方案：等待5-10秒，然后重试相同的搜索
- 小贴士：尝试更简单的搜索词（单个单词效果更好）
“未配置令牌”
获取您的代币：熊→ Help → 高级→ API代币→ 复制令牌，然后使用 set_bear_token
“未找到熊”
确保Bear已安装并至少打开过一次。
浏览器窗口出现
- 预期行为 由于贝尔的回拨系统
- Windows自动最小化并移出屏幕
- 如果它们持续存在，可以安全地手动关闭
- 焦点会自动返回到原始窗口
没有搜索结果
- 检查搜索词：确保它存在于你的笔记中
- 验证令牌：使用
check_bear_setup测试 - 尝试更宽泛的术语：单个单词往往比短语更有效
- 直接检查熊：验证内容是否存在于Bear应用程序中
技术细节
HTTP回调系统
服务器使用HTTP回调（端口51234）从Bear接收数据：
- Bear通过URL回调发送搜索结果和标签数据
- 由于此回调机制，浏览器窗口会短暂出现
- Bear响应超时20秒
- 常见故障的自动重试机制
性能特征
- 快速操作：笔记创建、文本添加（约1-2秒）
- 中型运营：单音符检索（~3-5秒）
- 运行速度较慢：搜索，标签列表（~5-15秒）
- 超时阈值：最多等待20秒
发展
要在开发模式下运行：
npm run dev要测试服务器，请执行以下操作：
npm run build
node dist/index.js版本历史记录
- v4.0.2：增强浏览器窗口处理，超时20秒
- v4.0.1：提高了回叫可靠性，更好的错误消息
- v4.0.0：通过回调系统恢复了全部功能
- v3.1.0：仅文档版本（功能有限）
需求
- Node.js 18或更高版本
- 您的系统上安装了Bear应用程序
- Claude桌面应用程序
- macOS（Bear仅适用于macOS）
许可证
麻省理工学院