MCP Apple Notes

🚀 MCP 蘋果筆記服務器

MCP 蘋果筆記服務器是一個支持語義搜索和 RAG（增強檢索生成）的 模型上下文協議 (MCP) 服務器。藉助它，AI 助手（如Claude）能夠在對話中搜索並引用您的蘋果筆記，為您帶來更智能、便捷的筆記使用體驗。

✨ 主要特性

• 🔍 使用 all-MiniLM-L6-v2 在設備上的嵌入模型進行語義搜索。
• 📝 具備全文搜索功能。
• 📊 向量存儲採用 LanceDB。
• 🤖 是與 AI 助手集成的 MCP 兼容服務器。
• 🍎 通過 JXA 實現原生蘋果筆記整合。
• 🏃♂️ 完全本地執行，無需 API 密鑰。

📦 安裝指南

先決條件

• Bun
• Claude Desktop

安裝步驟

1. 克隆倉庫：

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. 安裝依賴項：

bun install

💻 使用示例

基礎用法

1. 打開 Claude 桌面應用，轉到設置 -> 開發者 -> 編輯配置。
2. 打開 claude_desktop_config.json 並添加以下條目：

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

⚠️ 重要提示

需將 <YOUR_USER_NAME> 替換為您實際的用戶名。

3. 重啟 Claude 桌面應用。您應該看到如下界面：
4. 開始索引您的筆記。通過告訴 Claude“索引我的筆記”或“索引我的蘋果筆記”來開始索引。

📚 詳細文檔

故障排除

查看日誌：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# 或者
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

待辦事項

• [ ] 蘋果筆記以 HTML 格式返回。我們應將其轉換為 Markdown 並嵌入。
• [ ] 使用遞歸文本分割器或 Markdown 文本分割器對源內容進行分塊。
• [ ] 添加使用自定義嵌入模型的選項。
• [ ] 更多數據庫控制 - purge、自定義查詢等。
• [x] 通過 Claude 存儲筆記。