MCP Apple Notes

MCP Apple Notes

使用模型上下文协议在Claude中与您的Apple笔记交流。

MCP Apple Notes

概述

这是一个模型上下文协议(MCP)服务器,让Claude可以搜索并引用您的Apple Notes,提供语义搜索和RAG功能。

先决条件

安装步骤

  1. 克隆并安装

    git clone https://github.com/RafalWilinski/mcp-apple-notes
    cd mcp-apple-notes
    bun install
    
  2. 配置Claude Desktop

    • 打开Claude桌面应用 → 设置 → 开发者 → 编辑配置
    • 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

主要功能

  • 📊 使用LanceDB进行向量存储
  • 🔍 设备上嵌入模型提供语义搜索
  • 🍎 通过JXA本地集成Apple Notes
  • 🏃‍♂️ 完全本地执行,无需API密钥

现在您可以向Claude询问有关Apple Notes内容的问题,系统将自动搜索相关笔记并提供回答。