macOS Agent Bridge v0.2.0

macOS Agent Bridge v0.2.0

首次公开发行：通过 MCP 将 macOS 原生能力接入 AI Agent，并使用 Tinycast / Raycast 扩展管理权限、能力和待确认操作。

功能

• 63 个结构化 MCP 工具定义、5 个扩展命令，覆盖日历、提醒事项、文件、桌面、Apple 应用及公网查询接口。
• 独立 Node.js stdio 服务与 Swift Helper，共享参数校验、范围限制、审批与幂等收据。
• 普通写入可配置自动批准；高风险操作保留逐次确认；提供脱敏审计和操作状态查询。
• 中文主页与 README-EN.md，包含安装、客户端配置、能力覆盖和安全边界。

下载与安装

下载 macos-agent-bridge-macos-arm64.zip 与 SHA256SUMS，在同一目录运行 shasum -a 256 -c SHA256SUMS。解压后运行 Install.command，导入 Extension/，再单独配置 MCP 连接。包内包含官方 Node 运行时、生产依赖、预构建扩展与 Helper。

发行范围

这是开发阶段的公开版本。预构建包仅提供 Apple Silicon，Helper 为 ad-hoc 签名，未完成 Developer ID 公证或商店审核。macOS 可能阻止下载包首次运行；可按 README 从源码构建。63 是工具定义数，并不代表全部原生读写已完成实机验收。请先阅读能力覆盖矩阵与安全说明。

GitHub CI 已通过源码安装、类型检查、测试、TypeScript 构建、Swift Helper 构建和扩展构建。

发布前验证：55 项自动测试、TypeScript 检查、扩展与原生构建、3,706 文件隐私扫描及隔离 MCP 安装包检查均通过。

公开源码与安装包已排除本机配置、个人操作记录、原始诊断、备份和个人开发证书；二进制移除本机构建路径，ZIP 不携带 AppleDouble 元数据。

---

English

The first public release of macOS Agent Bridge connects MCP clients to native Mac capabilities, with Tinycast / Raycast controls for permissions and pending actions.

• 63 structured tool definitions and 5 extension commands.
• A standalone Node.js stdio server and Swift helper, with scoped file access, action approvals, idempotency and redacted audit records.
• Public web search, text fetching and connectivity diagnostics.
• Chinese-first documentation plus README-EN.md.

Download the Apple Silicon ZIP and SHA256SUMS, verify with shasum -a 256 -c SHA256SUMS, extract, run Install.command, import Extension/, then configure the MCP connection separately.

Development release: the helper is ad-hoc signed and is not Developer ID notarized. macOS may block downloaded binaries; source installation is documented. Tool definitions do not imply complete end-to-end verification of every native operation. Local configuration, machine diagnostics, personal records and developer certificates are excluded from the public artifacts.