苹果笔记语义搜索工具

MCP Apple Notes是一个基于模型上下文协议(MCP)的服务器,能够对苹果笔记进行语义搜索和检索增强生成(RAG),使AI助手如Claude能够在对话中搜索和引用您的苹果笔记。

  • by Tom-Semple
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 Tom-Semple/mcp-apple-notes-fixed

使用说明

MCP苹果笔记

A. 模型上下文协议(MCP) 通过Apple Notes启用语义搜索和RAG(检索增强生成)的服务器。这允许像克劳德这样的人工智能助手在对话中搜索和引用你的Apple Notes。

特性

  • 🔍 通过Apple Notes进行语义搜索 all-MiniLM-L6-v2 器件嵌入模型研究
  • 📝 全文搜索功能
  • 📊 矢量存储使用 LanceDB
  • 🤖 用于AI助手集成的MCP兼容服务器
  • 🍎 通过JXA集成原生Apple Notes
  • 🏃‍♂️ 完全本地执行-不需要API密钥

先决条件

安装

  1. 克隆存储库:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. 安装依赖项:
bun install

用法

  1. 打开Claude桌面应用程序,进入“设置”->“开发人员”->“编辑配置”
  1. 打开 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> 使用您的实际用户名。

  1. 重新启动Claude桌面应用程序。您应该看到:
  1. 首先为你的笔记建立索引。让克劳德为你的笔记建立索引,比如说:“为我的笔记建立索引来索引”或“为苹果笔记建立索引”。

故障排除

要查看日志,请执行以下操作:

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文本拆分器对源内容进行分块
  • []添加使用自定义嵌入模型的选项
  • []对数据库进行更多控制-清除、自定义查询等。
  • [x] 通过Claude在notes中存储笔记