基本能力
产品定位
Bear Notes MCP Server with RAG 是一个专为Bear Notes用户设计的工具,旨在通过AI技术增强笔记的搜索和使用体验。
核心功能
- 语义搜索:基于笔记的含义进行搜索,而不仅仅是关键词匹配。
- RAG支持:AI助手可以从笔记中提取相关上下文,即使没有明确提及。
- 本地处理:所有数据处理都在本地进行,无需API密钥或互联网连接。
- 优雅回退:如果语义搜索不可用,会自动回退到传统搜索。
适用场景
- 需要从大量笔记中快速找到相关内容的用户。
- 希望AI助手能够理解和使用个人知识库的用户。
- 注重数据隐私,希望所有处理都在本地进行的用户。
工具列表
- search_notes:根据查询查找匹配的笔记。
- get_note:通过ID获取特定笔记。
- get_tags:列出所有在Bear Notes中使用的标签。
- retrieve_for_rag:获取与查询语义相似的笔记,专门为RAG格式化。
常见问题解答
- 问题:索引过程耗时较长。
解答:这是正常现象,因为需要将笔记转换为数学向量。 - 问题:首次启动较慢。
解答:首次启动需要加载嵌入模型,之后会变快。 - 问题:添加新笔记后搜索不准确。
解答:需要重新运行npm run index
重建索引。
使用教程
使用依赖
- Node.js 16或更高版本
- Bear Notes for macOS
- 兼容MCP的AI助手客户端
安装教程
bash
git clone [your-repo-url]
cd bear-mcp-server
npm install
chmod +x src/bear-mcp-server.js
chmod +x src/create-index.js
调试方式
- 确保Bear数据库路径正确。
- 确保已运行
npm run index
进行索引。 - 检查Bear Notes数据库的权限。
- 确保服务器脚本可执行。
- 查看日志中的错误信息。