MCP Apple Notes Fixed

🚀 MCP 蘋果筆記

MCP 蘋果筆記是一個基於模型上下文協議（MCP）的服務器，它允許在你的 Apple Notes 上進行語義搜索和 RAG（檢索增強生成）。藉助該服務器，像 Claude 這樣的 AI 助手能夠在對話期間搜索並參考你的 Apple Notes，為你提供更智能的交互體驗。

✨ 主要特性

• 🔍 本地語義搜索：使用all-MiniLM-L6-v2在本地設備上實現語義搜索。
• 📝 全文搜索功能：支持對筆記進行全文搜索。
• 📊 向量存儲：採用LanceDB進行向量存儲。
• 🤖 MCP 服務器兼容性：可與 AI 助手兼容的 MCP 服務器。
• 🍎 原生集成：通過 JXA 實現與 Apple Notes 的原生集成。
• 🏃‍♂️ 本地執行：完全在本地執行，無需 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 索引你的筆記。你可以對它說：“索引我的筆記”或“索引我的 Apple Notes”。

🔧 故障排除

查看日誌：

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

📋 待辦事項

• [ ] 將 Apple 筆記從 HTML 格式轉換為 Markdown 並嵌入內容
• [ ] 使用遞歸文本分割器或 Markdown 文本分割器對源內容進行分塊
• [ ] 添加使用自定義嵌入模型的選項
• [ ] 更多對數據庫的控制——清空、自定義查詢等
• [x] 通過 Claude 將筆記存儲到 Notes 中