v1.2.0

MCP Dev Runtime v1.2.0

Native Windows support with isolated platform backends, self-contained x64 and ARM64 ZIPs, and unchanged macOS/Linux tool contracts.

Downloads / 下载

Choose the architecture of the computer where MDR will run:

Archive	Native release acceptance baseline
mcp-dev-runtime-1.2.0-darwin-arm64.tar.gz	Apple Silicon; macOS 14
mcp-dev-runtime-1.2.0-darwin-x64.tar.gz	Intel Mac; macOS 15
mcp-dev-runtime-1.2.0-linux-x64-gnu.tar.gz	Ubuntu 22.04 x64; glibc and GCC 12 libstdc++
mcp-dev-runtime-1.2.0-linux-arm64-gnu.tar.gz	Ubuntu 22.04 ARM64; glibc and GCC 12 libstdc++
mcp-dev-runtime-1.2.0-win32-x64.zip	Windows Server 2025 x64; additional local Windows 11 testing
mcp-dev-runtime-1.2.0-win32-arm64.zip	Windows 11 ARM64; native runner required

Every package includes Node.js 24.21.0, production dependencies and the runtime-only Tunnel from commit 70bb5a7e1305596f0216d7b18d0b7765d58576d5. Windows packages additionally contain the native mdr-windows-host.exe adapter and the matching image-processing prebuild. End users do not need to install Node, npm, Go, MSVC, Git Bash or WSL to run MDR. Development tools used by your own tasks remain your responsibility.

SHA256SUMS covers all six archives. VERIFICATION.json records the exact source commit and per-platform acceptance. GitHub build provenance is generated independently for each package. Publishing requires all six native builds and package checks to succeed; ARM64 cross-compilation alone is not sufficient.

Publisher code signing and Apple notarization remain intentionally skipped. Build provenance is not an OS publisher signature. Installers do not bypass execution policy, antivirus, Gatekeeper or other system protections.

Windows features

• Use the same six stable MCP tools over HTTP or stdio. PowerShell 7 is preferred when installed; otherwise Windows PowerShell 5.1 is used. No second agent or model is invoked.
• Native pipe execution and ConPTY interaction preserve UTF-8, real exit codes, output continuation and session history. Each task starts suspended, is assigned to an owned Job Object, and is resumed only after containment succeeds.
• Parent disconnection, cancellation and normal task completion clean owned descendants. Blocked terminal input cannot prevent the control channel from handling EOF or termination. Windows termination is not represented as a fabricated Unix signal.
• Private Windows DACLs, authenticated named-pipe control and orderly MCP shutdown protect configuration/state and flush history. Patches preserve destination access rules and CRLF; case-alias conflicts are rejected before writing.
• Preserve exact destination DACL inheritance flags even when Windows normalizes legacy ACLs during replacement. A metadata error after content replacement is reported as a partial change; it is not hidden as an untouched file.
• install.ps1 / uninstall.ps1 operate per user. Native command wrappers preserve arguments without CMD reparsing. Atomic current.json version pointers allow upgrades and rollback without junction privileges or overwriting loaded executables.
• Complete removal requires explicit y / Y, uses a temporary runtime to avoid Windows executable locks, and preserves source checkouts, external custom data paths and shared Skills.

Compatibility and reliability

The tool contract remains 3.1, the six stable defaults and existing schemas remain unchanged, and local Skill tools remain opt-in. Existing unified and legacy split configurations are preserved. macOS/Linux retain their POSIX process backends and do not load the Windows native adapter.

Lifecycle relative deadlines now use monotonic time. This corrects premature or prolonged timeouts caused by wall-clock adjustments, reproduced during repeated Linux/WSL startup checks; normal recorded timestamps are unchanged.

PowerShell is not Bash: Windows PowerShell 5.1 does not support && / ||. CMD/batch commands can be called inside PowerShell but cmd.exe is not a direct MDR shell backend in this release. Long-lived tasks must retain their active session: completing a command also cleans its detached descendants. Older programs emitting non-UTF-8 OEM output need their own encoding configuration; MDR does not guess.

Install and upgrade

Download the matching archive and SHA256SUMS, compare the full hash, then extract it.

Windows, from PowerShell in the extracted directory:

.\install.ps1

macOS/Linux:

./install.sh

Fill the private runtime.env locally with your own Tunnel ID and API key. Then use mdr start --bg, mdr doctor and mdr smoke. Set tunnel.enabled=false in unified configuration for local-only MCP without Tunnel credentials. Installation never starts or migrates a live service automatically.

If the command directory is not on PATH, follow the installer's instructions for your user PATH; no system PATH is changed. Windows defaults to %LOCALAPPDATA%\Programs\mcp-dev-runtime\bin, with private data under %LOCALAPPDATA%\mcp-dev-runtime.

Before upgrading or rolling back, review active tasks and stop the selected managed instance. Run the trusted package's installer with the same prefix/bin selection. Previous program versions and existing configuration are retained; published v1.0.0, v1.0.1 and v1.1.0 assets are not replaced.

Windows guide · Windows 中文指南 · macOS/Linux installation

Validation and limits

The development checkpoint passed 253 source tests on macOS ARM64 and Linux x64 (Ubuntu 24.04 under existing WSL2), 35 Windows x64 source tests, two native Go tests, 18 Mac package groups and 15 Windows package groups. Release CI independently rebuilds and tests the exact clean commit on all six native targets; the attached VERIFICATION.json is the release-specific record.

Local tests use isolated homes, workspaces and synthetic credentials. Mock/local Tunnel lifecycle or SDK success does not establish a real ChatGPT/WAN round trip on every OS. Model Skill selection, standard-user versus administrator environments, old Windows versions, sleep/wake and multi-day reliability remain separate acceptance scopes. No sandbox, multi-user isolation, Windows boot service or automatic dependency installation is added.

中文摘要

v1.2.0 新增 Windows x64 和 ARM64 原生运行包，支持 PowerShell、ConPTY、真实退出码和 UTF-8 输出、自有进程树管理、命名管道生命周期、私人 DACL、完整安装卸载及版本回退。运行包内置 Node、Tunnel 和对应架构依赖，不需要用户安装 Go、MSVC、Git Bash 或 WSL。

现有 macOS/Linux 后端、六个稳定工具及契约 3.1 保持兼容，Skill 仍需主动启用。另修复系统校时导致生命周期等待错误的问题。正式发布要求六个平台分别完成原生构建和最终安装包验收，ARM64 不以交叉编译代替运行证明。发布者签名及 Apple 公证继续跳过，现有发行版附件保持不变。