MCP Apple Notes

一个用于对 Apple Notes 进行语义搜索和检索的模型上下文协议 (MCP) 服务器。

特性

• 🔍 使用设备端嵌入模型的语义搜索
• 📝 全文搜索功能
• 💾 使用 LanceDB 的向量存储
• 🍎 原生 Apple Notes 集成

前提条件

• macOS（Apple Notes 集成必需）
• Bun JavaScript 运行时

安装

1. 克隆此仓库：

git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes

2. 安装依赖项：

bun install

用法

在 Cursor IDE 中配置

1. 打开 Cursor IDE

2. 转到 Settings → Features → MCP

3. 添加一个新的 MCP 服务器，配置如下：

   • 名称 (Name): Apple Notes
   • 类型 (Type): command
   • 命令 (Command): /path/to/bun /path/to/mcp-apple-notes/index.ts

   将 /path/to/bun 替换为 Bun 可执行文件的实际路径（使用 which bun 查找）并将 /path/to/mcp-apple-notes 替换为此仓库的实际路径。

4. 重启 Cursor IDE

使用 MCP 服务器

配置完成后，您可以在与 Claude 的对话中使用以下工具：

• list-notes: 列出所有 Apple Notes 标题
• index-notes: 为语义搜索索引您的笔记（首先执行此操作）
• get-note: 按标题检索特定笔记
• search-notes: 使用语义或关键字搜索来搜索您的笔记
• create-note: 创建具有指定标题和内容的新笔记

故障排除

如果您遇到问题：

1. 通过查看 Cursor 中的 MCP 服务器状态来检查服务器是否正在运行
2. 验证 MCP 服务器配置中的路径是否正确
3. 尝试直接在终端中运行该命令以查看任何错误消息
4. 确保 Apple Notes 可访问并且已授予权限

许可证

MIT