mcp-apple-notes

Apple Notes MCP Server 是一个本地 MCP 服务器，用于通过 LLM 与 Apple Notes 交互，实现笔记自动化。它提供了一套工具，使任何 MCP 兼容客户端能够无缝集成 Apple Notes，通过安全可靠的 AppleScript API 层完成完整的笔记操作。

用途

该服务器旨在让用户通过支持 MCP 的客户端（如 Continue.dev、Claude Desktop、Perplexity 等）自动化管理 Apple Notes，包括创建、读取、更新、删除笔记，以及管理文件夹和搜索内容。

笔记管理（6 个工具）：
- create_note：使用 HTML 内容创建笔记。
- read_note：通过 ID 读取笔记并验证。
- update_note：通过 ID 使用 HTML 内容更新笔记。
- delete_note：通过 ID 删除笔记并验证。
- move_note：在文件夹之间移动笔记。
- list_all_notes：列出所有文件夹中的所有笔记。
文件夹管理（5 个工具）：
- create_folder：创建文件夹，支持路径。
- read_folder：通过 ID 读取文件夹详情。
- rename_folder：通过 ID 重命名文件夹。
- delete_folder：通过 ID 删除文件夹。
- move_folder：在位置之间移动文件夹。
搜索与结构（3 个工具）：
- search_notes：通过关键词搜索笔记。
- list_folder_with_structure：显示文件夹层级。
- list_notes_with_structure：显示文件夹和笔记的层级。
内容支持：
- HTML 格式：<h1-h6>、<b><i><u>、<p><div><br>、<ul><ol><li>、<table>、<a>。
- 特殊功能：Unicode 和 emoji 支持（🚀、✅、📝）、嵌套文件夹路径（最多 5 级）、自动字符转义、富内容（标题、列表、表格）。

系统要求：
- macOS（AppleScript 支持所需）
- Python 3.10+（MCP SDK 兼容性所需）
- Apple Notes 应用程序（必须安装并可访问）
- MCP 兼容客户端（例如 Continue.dev、Claude Desktop）
安装步骤：
- 步骤 1：安装 uv（如果尚未安装）。
  - Windows (PowerShell)：
```
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
  - 替代（pip）：
```
pip install uv
```
- 步骤 2：添加 MCP 配置。将配置添加到 MCP 客户端（如 Perplexity、Cursor、Continue.dev、Claude Desktop）：
```
{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["mcp-apple-notes"]
    }
  }
}
```
  注意：确保 MCP 客户端在系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能中有权限访问 Apple Notes 并执行 AppleScript 命令。

服务器遵循 MCP 协议规范，采用模块化架构：