AirPods Recorder MCP — Mac 独立安装包 1.1

适用环境
macOS 13 或更新版本；包含 Apple Silicon 和 Intel 程序。
无需 Xcode、Swift、Python、Node.js 或项目源码。
自动配置支持 Codex、Claude Desktop、Cursor；请先安装要使用的客户端。
Codex 接入需要本机可运行的 codex 工具，引导会尝试从应用或常用路径查找。
Mac 与 iPhone 需使用同一 Apple 账号并开启 iCloud Drive。
仅支持远程 HTTP MCP 的云端客户端无法直接接入本机服务。

签名状态
正式发行安装包。包内程序（recorder-mcp 与「连接 AI 客户端」）使用
Developer ID Application 证书签名，安装包使用 Developer ID Installer 证书签名，
并已通过 Apple 公证；Hardened Runtime 与安全时间戳均已启用。
安装包的签名与公证可用以下命令核对：
  pkgutil --check-signature AirPodsRecorderMCP-1.1.0-universal.pkg
  spctl -a -vv --type install AirPodsRecorderMCP-1.1.0-universal.pkg
  xcrun stapler validate AirPodsRecorderMCP-1.1.0-universal.pkg
如果从非官方镜像下载后仍被 macOS 拦截，请核对 SHA-256 并从官方站点重新下载。

安装与接入
1. 在 iPhone「设置 → iCloud 与 AI 共享」中开启录音信息与转录同步。
2. 等待 Mac Finder 中的「iCloud Drive → AirPods Recorder → AgentLibrary」下载完成。
   建议将该目录保留在本机。
3. 双击 .pkg 安装，按安装器提示操作。系统可能要求管理员授权。
4. 安装结束会尝试打开「连接 AI 客户端」引导。如未自动打开，请到
   「应用程序 → AirPods Recorder MCP」双击「连接 AI 客户端.app」。
5. 选择客户端和 AgentLibrary 文件夹，点击「连接」。
   引导保留其他服务与客户端设置；已有同名服务时，会先询问是否替换。
   修改已有文件前，在原文件名后追加 .airpods-backup-<UUID> 生成备份。
6. 配置保存后，重新打开客户端，并按客户端提示允许使用 MCP 工具。
   调用 get_sync_status 检查同步状态。保存配置不等同于完成连接验证。
   需要连接多个客户端时，重复选择客户端并点击「连接」。

配置位置
Codex：~/.codex/config.toml（若引导启动环境设置了 CODEX_HOME，则使用该目录）。
Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json
Cursor：~/.cursor/mcp.json
Codex 使用官方 codex mcp add 命令；其他两款合并 mcpServers JSON。
带注释或格式损坏的 JSON 不会自动修改，请先修复文件后重试。
自定义 CODEX_HOME 可通过对应环境启动引导；GUI 不会自动读取 shell 启动文件。
客户端内的工具开关和授权仍需在客户端操作，配置工具不会代为批准。

其他客户端
本包提供 mcp-config.json 模板。可先运行 Check Status.command 选择共享目录，
再将模板内的服务条目合并到支持本地 stdio MCP 的客户端；保留已有服务。
命令：/Applications/AirPods Recorder MCP/bin/recorder-mcp
参数：--stdio

安装内容与数据
程序：/Applications/AirPods Recorder MCP
旧版目录书签：~/Library/Application Support/AirPodsRecorderBridge
按需原音缓存：~/Library/Caches/AirPodsRecorderBridge/Audio
自动配置将共享目录路径作为 --cloud-root 参数写入所选客户端。
不要移动安装目录或共享目录，否则请重新配置。
安装器只打开引导；点击「连接」后才会修改当前用户的客户端配置。
不添加开机启动项或常驻服务；MCP 由客户端按需启动，iCloud 由系统同步。
安装包不包含录音、转录、账号、开发者配置或目录书签。

可用工具
get_sync_status：同步状态、缺项与来源发布时间。
list_recordings：按时间列出录音。
search_transcripts：搜索转录并返回时间戳。
get_transcript：读取全文或指定时间范围。
get_audio：读取已共享原音的本机链接（不支持其他设备或公网访问）。
原音需在 iPhone 单独开启同步。客户端如何处理读取的数据，取决于该客户端。

检查与恢复
Check Status.command 会询问共享目录并检查本机可读状态，不会改动 AI 客户端配置。
no_published_sources：检查所选目录及手机是否已发布。
incomplete：等待 iCloud 下载后重试，并查看 issues。
not_shared：如需原音，先开启手机原音同步并等待新清单。
local_snapshot_available 只表示本机可见清单可读，不保证手机没有待同步更新。
配置错误时，请在客户端中删除 airpods-recorder 后重新配置；备份含原有完整配置，
恢复整个备份前，请确认不会覆盖备份后新增的设置。备份可能含敏感配置，请勿分享。

升级与卸载
后续安装包覆盖同一程序目录；升级前先断开客户端中的此 MCP。
安装器不会删除用户配置、目录书签、缓存或录音。
卸载时，先删除客户端中的 airpods-recorder，再将安装文件夹移到废纸篓。
