MCP Apple Notes 使用说明

项目简介

MCP Apple Notes 是一个基于 Model Context Protocol (MCP) 构建的服务器，它将您的 Apple Notes 转化为 AI 助手的可访问资源。通过这个服务器，您可以让支持 MCP 协议的 AI 应用（如 Claude）搜索、检索和利用您 Apple Notes 中的信息，实现更智能的对话和知识整合。

主要功能点

Apple Notes 语义搜索: 使用本地模型 'all-MiniLM-L6-v2' 对您的 Apple Notes 进行语义搜索。
全文搜索: 支持对 Apple Notes 内容进行全文搜索。
LanceDB 向量存储: 使用 LanceDB 本地数据库存储和管理向量数据，加速搜索。
MCP 兼容服务器: 作为一个标准的 MCP 服务器，可以与任何兼容 MCP 协议的 AI 客户端集成。
原生 Apple Notes 集成: 通过 JXA (JavaScript for Automation) 技术与 Apple Notes 应用进行本地集成。
完全本地运行: 所有操作都在本地执行，无需 API 密钥，保护您的数据隐私。

安装步骤

克隆仓库:

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

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

服务器配置

要将 MCP Apple Notes 服务器配置到 MCP 客户端（例如 Claude），您需要编辑客户端的配置文件。以 Claude Desktop 为例，按照以下步骤操作：

打开 Claude Desktop 应用，进入 'Settings' -> 'Developer' -> 'Edit Config'。

打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段下添加以下配置信息：

{
  "mcpServers": {
    "local-machine": {  // 服务器名称，可以自定义
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun", // MCP 服务器启动命令，指向 bun 可执行文件
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"] // MCP 服务器启动参数，指向 index.ts 文件
    }
  }
}

请务必将 '<YOUR_USER_NAME>' 替换为您的实际用户名。

重启 Claude Desktop 应用。您应该能在 Claude 的开发者设置中看到 "MCP Connected" 的状态，表示 MCP Apple Notes 服务器已成功连接。

基本使用方法

索引 Apple Notes: 首次使用或 Apple Notes 内容更新后，您需要先索引您的笔记。在 Claude 中，您可以输入类似 "Index my notes" 或 "Index my Apple Notes" 的指令来触发索引操作。索引过程可能需要几秒到几分钟，具体取决于您的笔记数量。
搜索 Apple Notes: 索引完成后，您可以使用类似 "Search my notes for [关键词]" 的指令，让 Claude 在您的 Apple Notes 中进行搜索。服务器将返回相关的笔记内容，Claude 可以利用这些信息进行对话或生成回复。
创建 Apple Notes: 您可以通过指令让 Claude 在 Apple Notes 中创建新的笔记，例如 "Create a note with title [笔记标题] and content [笔记内容]"。

查看日志

要查看 MCP 服务器的运行日志，可以使用以下命令：

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

关键词