MCP Apple Notes
2025.03.04
2
TypeScript语义搜索笔记管理Apple Notes 集成内容生成开发效率
MCP Apple Notes 是一个基于 Model Context Protocol (MCP) 的服务，专注于对 Apple Notes 进行语义搜索和检索。它提供了语义搜索、全文搜索、向量存储以及与 Apple Notes 的原生集成功能。适用于需要高效管理和检索 Apple Notes 内容的场景。
View on GitHub
Overview
基本能力
产品定位
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 运行时
安装教程
- 克隆仓库：
git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes
- 安装依赖：
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 访问权限