mcp-apple-notes

🚀 MCP 苹果笔记

MCP 苹果笔记是一个模型上下文协议（MCP）服务器，可用于对苹果笔记进行语义搜索和检索，极大提升笔记查找的效率和精准度。

🚀 快速开始

MCP 苹果笔记可帮助你高效地对苹果笔记进行语义搜索和检索。以下是使用前的准备和操作步骤。

✨ 主要特性

• 🔍 使用设备上的嵌入式模型进行语义搜索，精准定位所需笔记。
• 📝 具备全文搜索功能，不放过任何细节。
• 💾 使用 LanceDB 的向量存储，高效管理笔记数据。
• 🍎 实现原生苹果笔记集成，无缝对接苹果笔记应用。

📦 安装指南

先决条件

• macOS（用于苹果笔记的必要条件）
• 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. 转到 设置 → 特性 → MCP。

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

   • 名称：苹果笔记
   • 类型：命令
   • 命令：/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：列出所有苹果笔记的标题。
• index-notes：对笔记进行索引以备语义搜索（请先执行此操作）。
• get-note：通过标题获取特定笔记。
• search-notes：使用语义或关键字搜索笔记。
• create-note：创建带有指定标题和内容的新笔记。

📚 详细文档

故障排除

遇到问题时，可按以下步骤排查：

1. 检查服务器是否正在运行（查看 Cursor 中的 MCP 服务器状态）。
2. 验证配置中的路径是否正确。
3. 尝试在终端中直接运行命令以获取错误消息。
4. 确保苹果笔记可以访问且权限已授予。

📄 许可证

本项目采用 MIT 许可证。