MCP Apple Notes

这是一个使用模型上下文协议（MCP）的服务器，它能够对你的Apple Notes进行语义搜索和RAG（检索增强生成）。这使得像Claude这样的AI助手能够在对话中搜索并引用你的Apple Notes。

功能

• 🔍 使用设备上的嵌入模型all-MiniLM-L6-v2对Apple Notes进行语义搜索
• 📝 全文搜索能力
• 📊 使用LanceDB进行向量存储
• 🤖 支持与AI助手集成的MCP兼容服务器
• 🍎 通过JXA实现原生Apple Notes集成
• 🏃‍♂️ 完全本地执行 - 不需要API密钥

预备条件

• Bun
• Claude Desktop

安装

1. 克隆仓库：

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. 安装依赖：

bun install

使用方法

1. 打开Claude桌面应用，进入设置 -> 开发者 -> 编辑配置

2. 打开claude_desktop_config.json文件，并添加以下条目：

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

重要提示：将<YOUR_USER_NAME>替换为你的实际用户名。

3. 重启Claude桌面应用。你应该能看到如下内容：

4. 开始索引你的笔记。让Claude索引你的笔记，可以说：“索引我的笔记”或“索引我的Apple Notes”。

故障排除

查看日志：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# 或
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

待办事项

• 将返回的Apple笔记转换为HTML格式。我们应该将其转为Markdown并嵌入
• 使用递归文本分割器或Markdown文本分割器对源内容进行分块
• 添加使用自定义嵌入模型的选项
• 对数据库有更多的控制权 - 清除、自定义查询等
• 通过Claude将笔记存储在Notes中