
MCP Apple Notes

2025.03.04
7
TypeScript语义搜索检索增强生成Apple Notes集成内容生成开发效率
MCP Apple Notes 是一个基于模型上下文协议(MCP)的服务,旨在通过语义搜索和检索增强生成(RAG)技术,实现对Apple Notes的内容进行智能搜索和引用。该服务允许AI助手(如Claude)在对话中搜索和参考用户的Apple Notes。其主要特点包括本地执行的语义搜索、全文搜索能力、向量存储以及无需API密钥的完全本地执行。
View on GitHub
Overview
基本能力
产品定位
MCP Apple Notes 是一个专为Apple Notes设计的语义搜索和检索增强生成服务,旨在提升AI助手与用户笔记的交互能力。
核心功能
- 语义搜索:使用
all-MiniLM-L6-v2
模型在本地生成嵌入向量,实现语义搜索。 - 全文搜索:提供对Apple Notes的全文搜索能力。
- 向量存储:利用LanceDB进行向量存储。
- MCP兼容:支持与AI助手(如Claude)的集成。
- 本地执行:无需API密钥,完全在本地运行。
适用场景
- AI助手与用户笔记的智能交互。
- 快速检索和引用Apple Notes中的信息。
- 本地化、隐私保护的笔记搜索解决方案。
工具列表
- Bun:用于运行JavaScript/TypeScript的快速运行时。
- Claude Desktop:与MCP服务集成的AI助手桌面应用。
- LanceDB:用于向量存储的轻量级数据库。
常见问题解答
- 如何查看日志:使用
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
或tail -n 50 -f ~/Library/Logs/Claude/mcp.log
命令查看日志。 - 如何索引笔记:通过Claude桌面应用发送“Index my notes”或“Index my Apple Notes”指令。
使用教程
使用依赖
安装教程
- 克隆仓库:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
- 安装依赖:
bun install
调试方式
- 在Claude桌面应用的设置中添加MCP服务器配置。
- 重启Claude应用并验证连接状态。
- 使用日志命令监控运行状态。
许可证
None