WhiteMagic — governed local memory for agent continuity

whitemagic-mcp

通过 MCP 为 AI 编码 Agent 提供持久记忆和会话连续性。 WhiteMagic 是一个静态 Rust 二进制文件——本地优先、默认不收集遥测数据、采用 MIT 许可证——每次交接都可以签署为可验证的连续性回执。

适用于 Claude Code、Claude Desktop、Cursor、Codex、VS Code、opencode、Antigravity 和 Devin Desktop——各客户端的配置： https://www.whitemagic.dev/whitemagic/guide

此软件包会从 GitHub releases 安装并运行官方 wm 二进制文件（安装时会验证校验和），让 MCP 客户端无需手动下载即可启动它。

快速开始（无需安装步骤）

通过 npm 使用本地完整写入路径——软件包会在首次运行时下载并验证官方 wm 二进制文件的校验和。使用 @next dist-tag：npm 的 @latest 仍会解析到稳定的 v9 版本线。

npx -y whitemagic-mcp@next serve --profile curated

MCP 客户端配置：

{
  "mcpServers": {
    "whitemagic": {
      "command": "npx",
      "args": ["-y", "whitemagic-mcp@next", "serve", "--profile", "curated"]
    }
  }
}

或者直接试用二进制文件：

npx -y whitemagic-mcp@next selftest   # invariant self-test + host diagnostics
npx -y whitemagic-mcp@next --version  # wm 10.6.1
npx -y whitemagic-mcp@next doctor     # environment health check

二进制文件会缓存在 ~/.cache/whitemagic/bin/<release-tag>/ 下（遵循 XDG_CACHE_HOME）。@next 跟踪 v10 版本线；未指定版本的 @latest 安装则会获取稳定的 v9 版本线。使用 [email protected] 固定到确切版本，或通过 WHITEMAGIC_RELEASE 覆盖发行标签。

无需安装即可试用（托管只读通道）

评估通道运行于 https://mcp.whitemagic.dev/mcp （streamable-http；无 SLA）。免费使用，无需账户：

• 无需密钥即可进行服务发现（initialize / tools/list），用于目录探测；
• 匿名免费额度——每个客户端 IP 每天 3 次调用，无需密钥或请求头；
• 即时获取评估密钥：https://mcp.whitemagic.dev/keys （每天 50 次回忆调用，可选填电子邮件）；
• 支持 OAuth 2.1 的 MCP 客户端可使用 OAuth 2.1。

claude mcp add whitemagic-mcp --transport http https://mcp.whitemagic.dev/mcp

超出免费额度后，按次通过 x402（Base 上的 USDC）结算，无需密钥、账户或发票。npm 软件包仍提供本地完整写入路径。

平台

Linux x86-64（静态 musl）、Linux arm64（静态 musl）、macOS arm64 + x64 和 Windows x64 均已通过安装门控（CI 会针对已发布版本认证每个安装程序）。发行版本提供压缩的 .gz 分发包时会优先下载（体积约小 58%），否则回退到原始二进制文件。没有适用于你平台的资源？请从源码构建： https://github.com/lbailey94/whitemagic#install

隐私

你的记忆存储在自己的设备上。wm 不会主动向外连接；此安装程序仅会联系 GitHub releases，以下载二进制文件及其校验和。请参阅 PRIVACY_POLICY.md。

mcp-name: io.github.lbailey94/whitemagic-mcp