基本能力
产品定位
MCP Apple Notes 是一个专门用于语义搜索和检索 Apple Notes 内容的 MCP 服务器。
核心功能
- 🔍 语义搜索(使用设备上的嵌入模型)
- 📝 全文搜索能力
- 💾 使用 LanceDB 进行向量存储
- 🍎 原生 Apple Notes 集成
适用场景
- 需要高效管理和检索 Apple Notes 内容的用户
- 开发者在开发过程中需要快速查找和引用笔记内容
- 需要语义搜索功能来增强笔记检索体验的场景
工具列表
- list-notes: 列出所有 Apple Notes 标题
- index-notes: 为语义搜索索引笔记(首次使用前需要执行)
- get-note: 通过标题检索特定笔记
- search-notes: 使用语义或关键词搜索笔记
- create-note: 创建带有指定标题和内容的新笔记
常见问题解答
- 服务器未运行:检查 Cursor 中的 MCP 服务器状态
- 路径错误:验证 MCP 服务器配置中的路径是否正确
- 直接运行命令查看错误信息
- 确保 Apple Notes 可访问且已授予权限
使用教程
使用依赖
- macOS(Apple Notes 集成必需)
- Bun JavaScript 运行时
安装教程
- 克隆仓库:
bash
git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes - 安装依赖:
bash
bun install
在 Cursor IDE 中配置
- 打开 Cursor IDE
- 转到 Settings → Features → MCP
- 添加新的 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
调试方式
- 检查服务器是否运行
- 验证配置路径
- 直接在终端运行命令查看错误
- 检查 Apple Notes 访问权限