Bear Notes MCP Server with RAG

基本能力

产品定位

Bear Notes MCP Server with RAG 是一个专为Bear Notes用户设计的工具，旨在通过AI技术增强笔记的搜索和使用体验。

核心功能

• 语义搜索：基于笔记的含义进行搜索，而不仅仅是关键词匹配。
• RAG支持：AI助手可以从笔记中提取相关上下文，即使没有明确提及。
• 本地处理：所有数据处理都在本地进行，无需API密钥或互联网连接。
• 优雅回退：如果语义搜索不可用，会自动回退到传统搜索。

适用场景

• 需要从大量笔记中快速找到相关内容的用户。
• 希望AI助手能够理解和使用个人知识库的用户。
• 注重数据隐私，希望所有处理都在本地进行的用户。

工具列表

1. search_notes：根据查询查找匹配的笔记。
2. get_note：通过ID获取特定笔记。
3. get_tags：列出所有在Bear Notes中使用的标签。
4. retrieve_for_rag：获取与查询语义相似的笔记，专门为RAG格式化。

常见问题解答

• 问题：索引过程耗时较长。 解答：这是正常现象，因为需要将笔记转换为数学向量。
• 问题：首次启动较慢。 解答：首次启动需要加载嵌入模型，之后会变快。
• 问题：添加新笔记后搜索不准确。 解答：需要重新运行npm run index重建索引。

使用教程

使用依赖

• Node.js 16或更高版本
• Bear Notes for macOS
• 兼容MCP的AI助手客户端

安装教程

git clone [your-repo-url]
cd bear-mcp-server
npm install
chmod +x src/bear-mcp-server.js
chmod +x src/create-index.js

调试方式

1. 确保Bear数据库路径正确。
2. 确保已运行npm run index进行索引。
3. 检查Bear Notes数据库的权限。
4. 确保服务器脚本可执行。
5. 查看日志中的错误信息。

许可证

该项目遵循 MIT 开源许可条款。