M
MCP苹果笔记修复版服务器
@Tom-Semple/mcp-apple-notes-fixed
0 Stars
408 次浏览
Tom-Semple
更新于 2026-08-23
一个模型上下文协议服务器，它 enables 语义搜索和针对您苹果笔记的 RAG，允许像 Claude 这样的人工智能助手在对话期间搜索并引用您的笔记。 （注：此处“enables”可更流畅地翻译为“启用”，“RAG”如果需要具体解释可以进一步说明其含义，例如“检索增强生成”。） 优化后： 一个模型上下文协议服务器，启用语义搜索和针对您苹果笔记的检索增强生成（RAG），让像 Claude 这样的人工智能助手能够在对话中搜索并引用您的笔记。
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 索引您的笔记，可以说类似这样的话：“索引我的笔记”或“索引我的 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 中
