Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 20 Sep 12:18

MCP Dev Runtime v1.0.0

First stable release, distributed as platform-specific, self-contained runtime packages.

Downloads / 下载

Choose the archive matching the computer where commands will run:

Package Native verification baseline
mcp-dev-runtime-1.0.0-darwin-arm64.tar.gz Apple Silicon, macOS 14
mcp-dev-runtime-1.0.0-darwin-x64.tar.gz Intel Mac, macOS 15
mcp-dev-runtime-1.0.0-linux-x64-gnu.tar.gz Ubuntu 22.04 x64, glibc + GCC 12 libstdc++
mcp-dev-runtime-1.0.0-linux-arm64-gnu.tar.gz Ubuntu 22.04 ARM64, glibc + GCC 12 libstdc++

Each archive contains Node.js 24.21.0, the compiled application, production native dependencies, and tunnel-client-runtime from commit 70bb5a7e1305596f0216d7b18d0b7765d58576d5. No system Node/npm/Go/compiler is required to install or run MDR. SHA256SUMS covers the final archives; each archive includes BUILD-MANIFEST.json, SBOM.spdx.json and third-party notices/licenses. VERIFICATION.json records the per-platform package checks. GitHub build provenance is attached separately.

Publisher code signing and Apple notarization are deliberately skipped in v1.0.0. These are unsigned distributions, not OpenAI official binaries. A signing boundary is reserved in the build pipeline. macOS may require user approval; the installer does not bypass OS security.

What's included

  • Six direct MCP tools for shell commands, interactive PTYs, file patches, images, session queries and owned-process termination; HTTP and stdio transports, with optional ChatGPT Secure MCP Tunnel.
  • Bounded execution history, opt-in output capture, archived tail/search, retry deduplication and truthful exit/partial-change reporting. Tool contract remains 3.1.
  • User-level installer: private configuration and logs outside the program tree, versioned installation with atomic current switching, idempotent configuration preservation, and active-instance upgrade protection. mdr is auto-registered only when conflict-free; the canonical command remains mcp-dev-runtime.
  • Concise status, detailed status --verbose, full status --json, paths reporting only effective locations, and uptime including seconds.
  • English and Simplified Chinese installation, ChatGPT onboarding and troubleshooting documentation.

Installation

Download the correct archive and SHA256SUMS, compare its SHA-256, extract it, then run the included ./install.sh without sudo. Follow the printed PATH instruction when needed, fill your own Tunnel ID/API key in the generated private runtime.env, then use mdr up --background, mdr doctor and mdr smoke.

English installation guide · 中文安装指南

Upgrade and limitations

Stop the selected instance and review active work before changing installed versions. Existing configuration and previous versions are preserved. Source checkouts remain project-local and are not automatically migrated or re-registered; an existing source command is never overwritten. No npm publication is part of this release.

Windows, Alpine/musl, older untested OS versions, publisher signing/notarization, automatic OS boot services and multi-user isolation are not included. The runtime executes with the current user's permissions; it is not a sandbox or an approval layer. Keep the MCP listener on loopback and connect trusted clients only. Test evidence distinguishes the actual bundled Tunnel identity from mocked lifecycle tests: CI does not use real user Tunnel credentials and does not claim a real ChatGPT/WAN round trip on every platform.

中文摘要

首个稳定发行版提供四种平台预编译运行包,内置 Node、原生依赖和固定 commit 的 Tunnel,不再要求普通用户安装编译工具。安装器按用户目录分离配置、日志和程序版本;无冲突时自动注册 mdr,升级和重复安装保留配置,活动服务未停止时拒绝切换。

本版按要求暂不进行发布者签名和 Apple 公证,但保留以后接入的流水线步骤。下载后先核对 SHA256SUMS;解压执行 ./install.sh,填写自己的凭据后再启动。源码版不会自动迁移,npm 和 Windows 暂不发布。具体构建与验收记录见附件 VERIFICATION.json;CI 的模拟 Tunnel 测试不冒充各平台真实 ChatGPT 连接验证。