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 桌面应用程序，然后转到 Settings -> Developer -> Edit Config

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 通过说“Index my notes”或“Index my Apple Notes”来索引你的笔记。

故障排除

要查看日志：

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

待办事项

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