苹
苹果笔记搜索
@RafalWilinski/mcp-apple-notes
0 Stars
549 次浏览
RafalWilinski
更新于 2026-08-23
启用对你苹果笔记的语义搜索和RAG（检索增强生成）。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"local-machine": {
"args": [
"/Users/\u003cYOUR_USER_NAME\u003e/apple-notes-mcp/index.ts"
],
"command": "/Users/\u003cYOUR_USER_NAME\u003e/.bun/bin/bun"
}
}
}服务介绍
MCP Apple Notes
这是一个 Model Context Protocol (MCP) 服务器，它能够让你的 Apple Notes 支持语义搜索和 RAG（检索增强生成）。这使得像 Claude 这样的 AI 助手可以在对话中搜索并引用你的 Apple Notes。
特性
- 🔍 使用设备上的嵌入模型
all-MiniLM-L6-v2对 Apple Notes 进行语义搜索 - 📝 全文搜索功能
- 📊 使用 LanceDB 进行向量存储
- 🤖 与 AI 助手集成的 MCP 兼容服务器
- 🍎 通过 JXA 实现原生 Apple Notes 集成
- 🏃♂️ 完全本地执行 - 不需要 API 密钥
前提条件
安装
- 克隆仓库：
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
- 安装依赖项：
bun install
使用方法
- 打开 Claude 桌面应用程序并转到设置 -> 开发者 -> 编辑配置
- 打开
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> 替换为你的实际用户名。
- 重启 Claude 桌面应用程序。你应该会看到如下内容：
- 从索引你的笔记开始。告诉 Claude 索引你的笔记，比如：“Index my notes” 或 “Index my 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 笔记以 HTML 格式返回。我们应该将其转换为 Markdown 并嵌入
- 使用递归文本分割器或 Markdown 文本分割器来分割源内容
- 添加使用自定义嵌入模型的选项
- 对数据库有更多控制 - 清理、自定义查询等
- 通过 Claude 在 Notes 中存储笔记
