使用说明

项目简介

MCP Apple Notes 是一个基于 Model Context Protocol (MCP) 的服务器实现，它允许AI助手（如 Claude）访问和利用您本地的 Apple Notes 数据。通过这个服务器，AI助手可以对您的笔记进行语义搜索和检索，从而在对话中引用和利用您的个人知识库。

主要功能点

Apple Notes 集成: 无缝连接您的 Apple Notes 应用，直接访问您的笔记内容。
语义搜索: 利用 'all-MiniLM-L6-v2' 模型进行本地语义搜索，更精准地找到相关笔记。
全文搜索: 支持关键词全文搜索，快速定位包含特定文本的笔记。
RAG (检索增强生成): 为 AI 助手提供检索到的笔记内容，增强其生成回复的上下文信息。
LanceDB 向量存储: 使用 LanceDB 本地数据库存储笔记向量，加速搜索。
完全本地执行: 所有操作都在本地完成，无需 API 密钥，保护您的数据隐私。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/RafalWilinski_mcp-apple-notes
cd RafalWilinski_mcp-apple-notes

安装依赖: 确保您已安装 Bun，然后在项目目录下运行：
```
bun install
```

服务器配置

要将 MCP Apple Notes 服务器连接到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例，您需要编辑其配置文件 'claude_desktop_config.json'，并添加以下 'mcpServers' 配置：

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

请务必替换 '<YOUR_USER_NAME>' 为您实际的用户名。 'command' 指向 Bun 的可执行文件路径，'args' 是运行 'index.ts' 服务器脚本的路径。 'local-machine' 是您为该 MCP 服务器自定义的名称，在 Claude Desktop 中用于标识连接状态。

基本使用方法

启动 Claude Desktop 客户端 并确保已完成上述服务器配置。
索引笔记: 在 Claude 中，您可以发送指令如 "Index my notes" 或 "Index my Apple Notes" 来触发服务器索引您的 Apple Notes。首次索引可能需要一些时间，取决于您的笔记数量。
搜索笔记: 索引完成后，您可以向 Claude 提问，Claude 将利用 MCP Apple Notes 服务器进行语义搜索，并结合您的笔记内容进行回复。例如，您可以询问 "关于上次会议的笔记有哪些？" 或 "搜索包含关键词 '项目计划' 的笔记"。
创建笔记: 您��以使用 "create-note" 工具让 Claude 在 Apple Notes 中创建新笔记。例如，您可以指示 Claude "创建一个标题为 '购物清单'，内容为 '牛奶，鸡蛋，面包' 的笔记"。

查看日志

如需查看服务器运行日志，可以使用以下命令：

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

关键词