Skip to content

Releases: juliusloon/macos-agent-bridge

Release list

macOS Agent Bridge v0.3.0

macOS Agent Bridge v0.3.0 Latest
Latest

Choose a tag to compare

View all tags
@juliusloon juliusloon released this 22 Oct 16:08
v0.3.0
828ea57

macOS Agent Bridge v0.3.0

0.3.0 聚焦系统时间与联网可靠性：本机时钟直达、联网错误可诊断、DNS 提供加密回退。

功能与改进

  • system_status 在 MCP runtime 直接返回本机当前日期、时间、IANA 时区、UTC 偏移和毫秒时间戳，无需联网、Helper 或系统授权；处理"今天""明天"等相对日期时先调用它。
  • 联网错误保留 DNS、连接、代理、TLS、HTTP 各阶段信息、底层错误码 causeCode、是否可重试 retryable 及处理建议 hint；瞬时连接错误在同一总超时内最多尝试三个不同的已验证公网 IP。
  • 系统 DNS 失败或答案含非公网地址时，回退到固定 IP 引导、证书校验的 Cloudflare HTTPS DNS；重新校验所有答案并固定公网 IP，可用 BRIDGE_DNS_FALLBACK=off 关闭。
  • web_fetch 和 network_check 的 HTTP 结果增加本机获取时间 fetchedAt 与规范化的服务器 serverDate；继续保持公网地址、TLS 验证及响应大小限制。
  • Agent 指引更新：相对日期先读本机时钟，不从行情、事件或 uptime 推断时间；网络失败按 phase/causeCode/hint 诊断，限制无效重复重试。
  • 新增日期与联网故障排查文档。

验证

  • 69 项自动测试、TypeScript 检查、扩展与原生构建通过；GitHub CI 对本次推送运行相同流程。
  • 发布前验证：离线包隐私扫描（3,708 文件，无本地路径、密钥、凭据、状态或元数据）、ad-hoc 签名、安装脚本语法、独立 Node/MCP 运行时、63 工具、5 命令与路径迁移检查全部通过。

下载与安装

下载 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 是工具定义数，并不代表全部原生读写已完成实机验收。请先阅读能力覆盖矩阵与安全说明。

English

v0.3.0 focuses on system time and network reliability.

  • system_status now reads the host clock directly in the MCP runtime and returns localDate, localTime with a UTC offset, IANA timezone and unixTimeMs — offline, without the native helper or macOS permissions. Resolve relative dates with it first.
  • Network errors expose the failing phase (DNS, connect, proxy, TLS, HTTP), underlying causeCode, retryable and a hint; transient connection failures try up to three different validated public IPs within one overall timeout.
  • Failed or non-public system DNS answers fall back to Cloudflare HTTPS DNS over certificate-validated fixed IPs; all answers are revalidated and pinned to public addresses. Set BRIDGE_DNS_FALLBACK=off to disable.
  • web_fetch and network_check HTTP results include fetchedAt and a normalized serverDate; public-address, TLS-verification and size limits are unchanged.
  • New date and network troubleshooting document (docs/NETWORK-TROUBLESHOOTING.md, Chinese).

Pre-release verification: 69 automated tests, TypeScript checks, extension and native builds, a 3,708-file privacy scan, ad-hoc signature, installer syntax, standalone Node/MCP runtime with 63 tools and 5 commands, and path relocation all pass.

Development release: Apple Silicon only; the helper is ad-hoc signed and not Developer ID notarized. macOS may block the first launch; build from source if needed. Tool definitions do not imply complete end-to-end verification of every native operation.

Assets 4
Loading

macOS Agent Bridge v0.2.0

macOS Agent Bridge v0.2.0

Choose a tag to compare

View all tags
@juliusloon juliusloon released this 20 Oct 16:48
v0.2.0
1206c2b

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.

Loading