MCP Apple Notes

MCP Apple Notes

site icon
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.logtail -n 50 -f ~/Library/Logs/Claude/mcp.log命令查看日志。
  • 如何索引笔记:通过Claude桌面应用发送“Index my notes”或“Index my Apple Notes”指令。

使用教程

使用依赖

安装教程

  1. 克隆仓库:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. 安装依赖:
bun install

调试方式

  1. 在Claude桌面应用的设置中添加MCP服务器配置。
  2. 重启Claude应用并验证连接状态。
  3. 使用日志命令监控运行状态。

许可证

None