Cursor Apple Notes Indexer 使用说明

项目简介

Cursor Apple Notes Indexer 是一款 Cursor 编辑器的 MCP (Model Context Protocol) 应用，它能够索引您本地的 Apple Notes 数据，并在 Cursor 编辑器内提供强大的搜索功能。通过该应用，您可以方便快捷地在 Cursor 中检索和访问您的 Apple Notes 内容，提升工作效率。

主要功能点

Apple Notes 搜索: 无需离开 Cursor 编辑器即可快速查找 Apple Notes。
渐进式索引: 首次使用时建立索引，后续使用过程中增量更新索引。
实时更新: 支持手动重新索引，以捕获最新的 Apple Notes 内容。
高级搜索: 支持文件夹、日期范围和排序等高级搜索操作符，实现精准搜索。
本地存储: 所有索引数据均存储在本地机器上，保障数据隐私。

安装步骤

克隆仓库：将仓库 'https://github.com/packetnomad/cursor-apple-notes-indexer' 克隆到本地。
在 Cursor 中打开：使用 Cursor 编辑器打开克隆的文件夹。
安装依赖：在终端中运行 'npm install' 命令安装项目依赖。
安装 MCP 应用：在 Cursor 编辑器的 MCP 面板中安装该应用。具体操作为：
- 打开 Cursor 设置 (Cmd+, 或 Ctrl+,)
- 搜索 "MCP Apps" 或 "Model Context Protocol Apps"
- 点击 "Add Server" 按钮
- 填写以下服务器配置信息

服务器配置 (MCP 客户端配置)

在 Cursor 编辑器 MCP 应用配置中，您需要添加以下服务器配置信息以连接到 Apple Notes Indexer MCP 服务器：

{
  "serverName": "Apple Notes Indexer",
  "command": "node",
  "args": ["index.js"]
}

配置参数说明:

'serverName': MCP 服务器的名称，可以自定义，例如 "Apple Notes Indexer"。
'command': 启动 MCP 服务器的命令，这里使用 'node' (确保您的系统已安装 Node.js 环境)。
'args': 传递给 'command' 的参数，这里指定 'index.js' 为入口文件。请确保 'index.js' 文件位于您在 Cursor 中打开的项目根目录下。

基本使用方法

索引 Apple Notes:
- 打开 Cursor 命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)。
- 输入并选择 "Apple Notes Indexer: Index Notes" 命令。
- 等待索引过程完成。首次索引可能需要一些时间，取决于您的 Apple Notes 数量。
搜索 Apple Notes:
- 打开 Cursor 命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)。
- 输入并选择 "Apple Notes Indexer: Search Notes" 命令。
- 在输入框中输入您的搜索关键词，即可查看搜索结果。
高级搜索:
- 在搜索关键词中可以使用高级操作符进行更精确的搜索，例如：
  - 'folder:"工作"' - 搜索 "工作" 文件夹下的笔记。
  - 'date:"2023-01-01 to 2023-12-31"' - 搜索 2023 年的笔记。
  - 'sort:dateNewest' - 按日期从新到旧排序。
  - 组合使用： '会议记录 folder:"项目A" date:"2024-01-01 to 2024-03-01" sort:dateNewest'
查看索引状态:
- 打开 Cursor 命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)。
- 输入并选择 "Apple Notes Indexer: View Index" 命令，即可查看索引状态和统计信息。

注意事项

该应用依赖 macOS 系统和 Apple Notes 应用。
首次使用需要授权 Cursor 访问 Apple Notes，请根据提示在 “系统偏好设置 - 安全性与隐私 - 隐私 - 自动化” 中允许 Cursor 控制 “Notes” 应用。

关键词