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 許可證。