Apple Notes MCP Server 使用说明

项目简介

Apple Notes MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将您的本地 Apple Notes 数据库连接到 Claude Desktop 等 LLM 客户端，扩展 LLM 的上下文理解能力。通过此服务器，Claude 可以访问和搜索您存储在 Apple Notes 中的笔记，从而更好地理解您的个人知识和信息。

主要功能点

资源 (Resources) 管理: 将 Apple Notes 数据库中的笔记作为资源进行管理，允许客户端访问笔记列表和内容。
工具 (Tools) 提供:
- 'get-all-notes': 获取所有笔记的标题列表。
- 'read-note': 获取指定笔记的完整内容。
- 'search-notes': 根据关键词搜索笔记。
Prompt 模板 (Prompts): 提供 'find-note' Prompt，支持根据用户查询查找相关笔记。

安装步骤

安装服务器: 推荐使用 'uv' 工具安装 'apple-notes-mcp' 服务器。打开终端并执行以下命令之一：
```
uvx apple-notes-mcp
```
或者
```
uv pip install apple-notes-mcp
```
如果您没有安装 'uv'，请先参考 uv 官方文档安装。
配置 Claude Desktop: 根据您的操作系统，找到 Claude Desktop 的配置文件 'claude_desktop_config.json'：
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
打开 'claude_desktop_config.json' 文件，在 '"mcpServers"' 字段下添加 'apple-notes-mcp' 服务器的配置。

服务器配置

根据您的安装方式，选择以下配置添加到 'claude_desktop_config.json' 的 '"mcpServers"' 字段中：

开发/未发布服务器配置 (如果您使用 'uv pip install' 安装):

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}", //  "{project_dir}" 需要替换为您的项目目录，通常 Claude Desktop 会自动处理
      "run",
      "apple-notes-mcp"
    ]
  }
}

已发布服务器配置 (如果您使用 'uvx' 安装):

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

注意:

请确保您的 Mac OS 已经授予 "完全磁盘访问权限" 给运行 MCP Server 的进程，因为 Apple Notes 数据库位于受保护的目录下。您可以在 "系统偏好设置" -> "安全性与隐私" -> "完全磁盘访问权限" 中进行设置。
'{project_dir}' 通常由 Claude Desktop 自动替换为项目目录，您无需手动修改。

基本使用方法

配置完成后，启动 Claude Desktop。Claude 即可通过 MCP Server 访问您的 Apple Notes 笔记。您可以指示 Claude 使用以下工具来操作笔记：

使用 'get-all-notes' 工具获取所有笔记标题列表。
使用 'read-note' 工具并提供 'note_id' 参数来读取特定笔记的内容 (例如: '{"note_id": "your_note_id"}'). 'note_id' 可以从 'get-all-notes' 工具的输出中获取，或者通过其他方式获取笔记的 URI。
使用 'search-notes' 工具并提供 'query' 参数来搜索包含特定关键词的笔记 (例如: '{"query": "您的搜索关键词"}').

您可以通过自然语言指令引导 Claude 使用这些工具，例如：

"列出我所有的笔记标题" (Claude 可能会调用 'get-all-notes' 工具)
"读取标题为 '会议记录' 的笔记" (Claude 可能会调用 'search-notes' 或其他方式找到笔记，然后调用 'read-note' 工具)
"搜索关于 '项目计划' 的笔记" (Claude 可能会调用 'search-notes' 工具)

关键词