JinDaGe - mcp-apple-notes-fixed MCP Details

article

README

🚀 MCP 苹果笔记

MCP 苹果笔记是一个基于模型上下文协议（MCP）的服务器，它支持在你的 Apple Notes 上进行语义搜索和 RAG（检索增强生成）。借助该服务器，像 Claude 这样的 AI 助手能够在对话时搜索并参考你的 Apple Notes，为你提供更智能、更个性化的服务。

MCP 苹果笔记

✨ 主要特性

🔍 本地语义搜索：使用all-MiniLM-L6-v2在本地设备上实现语义搜索。
📝 全文搜索功能：支持对 Apple Notes 进行全文搜索。
📊 向量存储：采用LanceDB进行向量存储。
🤖 MCP 服务器：与 AI 助手兼容，方便 AI 助手在对话中搜索和参考 Apple Notes。
🍎 原生集成：通过 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>替换为你的实际用户名。 3. 重启 Claude 桌面应用程序。你应该看到如下界面： Claude MCP 连接状态 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 文本分割器对源内容进行分块
[ ] 添加使用自定义嵌入模型的选项
[ ] 更多对数据库的控制——清空、自定义查询等
[x] 通过 Claude 将笔记存储到 Notes 中

mcp-apple-notes-fixed