SuperAPI AI 工具集

apple-notes-mcp

apple-notes-mcp 是一个面向 Claude Desktop 的模型上下文协议(MCP)服务器,用于读取本地 Apple Notes 数据库,让 Claude 能够访问和搜索你的笔记内容。根据项目说明,该服务器支持读取和写入 Apple Notes,并提供获取全部笔记、读取指定笔记完整内容、搜索笔记等多个提示词(prompts)功能,同时列出了不支持加密笔记、固定笔记过滤、附件内容获取、清单状态、创建或编辑笔记等限制。

访问官网

工具介绍

apple-notes-mcp 是 sirmews 开发的一个模型上下文协议(MCP)服务器,专为 Claude Desktop 设计。它的核心用途是读取本地的 Apple Notes 数据库,并将笔记内容提供给 Claude Desktop,使 Claude 能够搜索那些容易被遗忘的笔记,从而更了解用户的信息。项目说明中写道:“现在 Claude 可以搜索你最被遗忘的笔记,并更加了解你。”

主要能力方面,该服务器实现了读取和写入 Apple Notes 的功能,并提供多个提示词(prompts):get-all-notes 用于获取所有笔记;read-note 用于获取特定笔记的完整内容;search-notes 用于搜索笔记。

使用方式上,推荐使用 uv 在本地安装该服务器,然后按照说明在 Claude 的配置文件中添加配置。配置文件位置:macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 为 %APPDATA%/Claude/claude_desktop_config.json。可能需要使用 uv 的直接路径,可通过 which uv 命令查找路径。项目还提供了开发/未发布服务器配置和已发布服务器配置的说明。

在 macOS 磁盘权限方面,需要为该服务器授予完全磁盘访问权限(Full Disk Access),因为 Apple Notes 的 sqlite 数据库嵌套在 macOS 文件系统深处。

关于构建与发布,项目说明了准备分发包的步骤:同步依赖并更新锁文件、构建包分发(会在 dist/ 目录中生成源码和 wheel 分发)、发布到 PyPI(需要通过环境变量或命令标志设置 PyPI 凭据:令牌使用 --token 或 UV_PUBLISH_TOKEN;用户名/密码使用 --username / UV_PUBLISH_USERNAME 和 --password / UV_PUBLISH_PASSWORD)。

由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性。为获得最佳调试体验,强烈建议使用 MCP Inspector,可通过 npm 命令启动,启动后 Inspector 会显示一个 URL,可在浏览器中访问以开始调试。

该项目采用 MIT 许可证,源代码可在 GitHub 上获取。作者欢迎通过 Bluesky 发送想法和反馈,或提交 issue。

已知缺失的功能(Missing Features)包括:不处理加密笔记(ZISPASSWORDPROTECTED);不支持固定笔记过滤;不处理云同步状态;缺少附件内容检索;不支持清单状态(ZHASCHECKLIST);无法创建或编辑笔记。

以上为项目说明中明确提供的信息,其他功能、收费、价格、平台或使用效果等细节暂未提供。