MCP Apple Notes

MCP Apple Notes

一个 Model Context Protocol（MCP） 服务，可在 Apple Notes 中进行语义搜索和 RAG（检索增强生成）。借助此服务，Claude 等 AI 助手可以在对话期间搜索和引用你的 Apple Notes。

功能

• 🔍 使用设备端嵌入模型 all-MiniLM-L6-v2 对 Apple Notes 进行语义搜索
• 📝 全文搜索功能
• 📊 使用 LanceDB 存储向量
• 🤖 兼容 MCP 的服务，可与 AI 助手集成
• 🍎 通过 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 发送类似“为我的笔记建立索引”或“为我的 Apple Notes 建立索引”的请求。

故障排除

查看日志：

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

待办事项

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