MCP Apple Notes

🚀 MCP 苹果笔记

MCP 苹果笔记是一个模型上下文协议（MCP）服务器，专为苹果笔记打造，可实现语义搜索和检索功能，极大提升信息查找效率。

🚀 快速开始

MCP 苹果笔记服务器能助力你高效搜索和检索苹果笔记。以下是使用前的准备步骤。

✨ 主要特性

• 🔍 使用设备上的嵌入式模型进行语义搜索：借助设备自带的嵌入式模型，实现精准的语义搜索。
• 📝 全文搜索功能：支持对笔记全文进行搜索，不放过任何关键信息。
• 💾 使用 LanceDB 的向量存储：利用 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 许可证。