Flux Cloud

Flux Cloud MCP 服务

一个 MCP 服务，让任何 AI Agent 都能使用去中心化云平台 Flux Cloud：以美元报价、部署应用、支付费用、查看应用启动情况、读取日志、更新应用 和取消应用。兼容 Claude Code、Claude Desktop、Cursor、Windsurf、 OpenCode 及所有其他 MCP 主机。

无需账户。身份信息仅由两把密钥组成：

密钥	地址	作用
FLUX_ID_PRIVATE_KEY	Flux ID，1...	拥有应用。为规格和 API 会话签名。不持有资金。
FLUX_PAYMENT_PRIVATE_KEY	Flux 地址，t1...	持有 FLUX，并在链上支付部署费用。

服务会为你生成一对密钥（flux_generate_keys）；向付款地址转入 FLUX，然后即可部署。

定价政策

本服务显示的所有价格都是 Flux Cloud 美元价格，与 home.runonflux.io 收取的价格相同，并按实时市场汇率换算为 FLUX，同时享受使用 FLUX 付款的 5% 折扣。报价直接来自网络（/apps/calculatefiatandfluxprice），因此包含 $0.99 最低价格、硬件和期限折扣，以及更新抵扣额。

区块链自身的接受门槛要低好几倍。本服务绝不会将其显示为价格；它只会在广播付款前将其作为安全检查。

安装

npm install -g @runonflux/flux-cloud-mcp     # or: yarn global add @runonflux/flux-cloud-mcp

也可以不安装，直接运行：npx @runonflux/flux-cloud-mcp。

Claude Code

claude mcp add flux-cloud -s user \
  -e FLUX_ID_PRIVATE_KEY=<wif> -e FLUX_PAYMENT_PRIVATE_KEY=<wif> \
  -- npx -y @runonflux/flux-cloud-mcp

Claude Desktop、Cursor、Windsurf（JSON 配置）

{
  "mcpServers": {
    "flux-cloud": {
      "command": "npx",
      "args": ["-y", "@runonflux/flux-cloud-mcp"],
      "env": {
        "FLUX_ID_PRIVATE_KEY": "<wif of the Flux ID>",
        "FLUX_PAYMENT_PRIVATE_KEY": "<wif of the payment address>"
      }
    }
  }
}

密钥为可选项。没有密钥时，所有只读工具仍可正常使用；flux_generate_keys 会生成一对密钥，供你填入配置。

OpenCode

{
  "mcp": {
    "flux-cloud": {
      "type": "local",
      "command": ["npx", "-y", "@runonflux/flux-cloud-mcp"],
      "environment": {
        "FLUX_ID_PRIVATE_KEY": "<wif>",
        "FLUX_PAYMENT_PRIVATE_KEY": "<wif>"
      }
    }
  }
}

工具

工具	功能	消耗 FLUX
flux_get_identity	Flux ID、付款地址、以 FLUX 和 USD 计价的余额	否
flux_generate_keys	新的 Flux ID 和付款密钥对，以及设置说明	否
flux_get_pricing	USD 价目表、FLUX/USD 汇率、折扣、参考规格	否
flux_build_spec	将简单描述（镜像、端口、cpu/ram/hdd、月数）转换为完整的 v8 规格	否
flux_validate_spec	本地规则检查，并在 FluxOS 节点上验证	否
flux_quote_app	注册或更新的 USD 价格和应付 FLUX	否
flux_deploy_app	生成方案（默认），或使用 confirm=true 签名、广播并付款	使用 confirm
flux_wait_for_app	轮询直到应用获接受且实例运行；返回 URL	否
flux_get_app	任意应用的规格、到期时间、实例和 URL	否
flux_list_my_apps	由 Flux ID 所有的应用，以及实例数量和剩余天数	否
flux_get_app_logs	正在运行的实例的容器日志（仅所有者可用）；自动选择组件，使用所有者密钥解密私有应用	否
flux_get_app_stats	实例的实时 CPU/内存/网络数据（仅所有者可用）	否
flux_control_app	按节点或全局重启、重新部署或移除实例	否
flux_cancel_app	缩短应用期限以提前结束应用	使用 confirm
flux_get_network_info	节点数量、区块高度、FLUX/USD、部署地址	否

资源 flux://guide/overview、flux://guide/spec-format、 flux://guide/pricing 和 flux://guide/gotchas 为 Agent 提供领域知识； deploy_on_flux 提示词将引导它完成部署。

典型会话

> deploy nginx on flux, 3 instances, one month

flux_get_identity      -> Flux ID 1Ab..., payer t1Cd..., 996.98 FLUX ($48.74)
flux_build_spec        -> v8 spec, port 39978 -> 80, r:/data, valid
flux_quote_app         -> $0.99 for 1 month, pay 19.24 FLUX (5% FLUX discount)
   user agrees
flux_deploy_app confirm=true
                       -> message hash 8d2f..., paid 19.24 FLUX, txid 0c41...
flux_wait_for_app      -> accepted at height 2941560, 3/3 instances running
                          https://myapp.app.runonflux.io

部署的工作方式

1. 通过 api.runonflux.io 验证规格，验证方式与注册时完全相同（镜像可访问、架构、端口、名称未被占用）。如果负载均衡器拒绝请求，则会探测几个健康节点并依次尝试。
2. 网络会报价 USD 价格；服务器会检查付款方的余额。
3. 设置 confirm=true 后，Flux ID 会对规格签名，同一端点会将其广播到网络，并返回一个 64 个字符的消息哈希。
4. 付款地址会将报价对应的 FLUX 发送到网络部署地址，并在 OP_RETURN 输出中附上哈希。签名前会根据刚获取的价格表重新检查金额，因为付款不足的消息会被静默丢弃，且 FLUX 不会退款。
5. 节点会将已确认的付款与消息配对，并发布应用。随后实例会启动并拉取镜像。

私有（企业）应用会发布空组件列表，因此 flux_get_app、flux_get_app_logs 和 flux_get_app_stats 会在配置或传入所有者密钥时，从 ArcaneOS 节点获取解密后的规格。只会返回组件名称、镜像、端口和大小；环境变量、命令和注册表凭据绝不会离开服务器。

更新使用相同的工具：同一所有者已有的应用会收到 fluxappupdate 消息，网络会将旧期限中未使用的部分记入账户。通过 enterprise 参数支持私有（企业）应用：组件会加密后发送给网络，且只有 ArcaneOS 节点可以运行它们。

托管服务器：mcp.runonflux.com

同一服务器也运行在 Flux Cloud 上，通过 Streamable HTTP 提供服务，供无法启动本地进程的主机使用（claude.ai 连接器、ChatGPT、浏览器和移动端 Agent）。将其添加为远程 MCP 服务：

https://mcp.runonflux.com/mcp   (also https://mcp.runonflux.io/mcp)

托管服务器不持有任何密钥。只读工具无需密钥。需要签名或付款的工具会将 fluxIdPrivateKey 和 paymentPrivateKey 作为调用参数，并仅在该次调用期间在内存中使用，绝不会记录或存储。服务器的指令会告诉 Agent 使用 flux_generate_keys 创建专用密钥对，并让用户只为部署所需的金额充值，而不是索要其他用途钱包的密钥。输入聊天的任何内容都会经过 AI 供应商和主机的历史记录，因此请将此类密钥对视为一次性的，并保持余额较低。如需更大的预算，请运行本地服务器，密钥不会离开你的设备。

使用 Docker 运行你自己的副本：

docker run -p 3000:3000 runonflux/flux-cloud-mcp

该服务无状态，因此任意数量的实例都可以置于同一个负载均衡器之后。GET /healthz 会报告运行状态。运行公共实例的 Flux 应用规格位于 deploy/cloudmcp.json。

配置

变量	默认值	用途
FLUX_ID_PRIVATE_KEY		Flux ID（所有者）的 WIF
FLUX_PAYMENT_PRIVATE_KEY		付款地址的 WIF
FLUX_API_URL	https://api.runonflux.io	用于读取和获取报价的负载均衡 FluxOS API
FLUX_NODE_URL	auto	为注册指定一个 FluxOS 节点
FLUX_EXPLORER_URLS	explorer.runonflux.io,flux-explorer.sspwallet.io	用于查询 UTXO 和广播的 Insight 区块浏览器
FLUX_STATS_URL	https://stats.runonflux.io	USD 汇率表
FLUX_RATES_URL	https://viprates.runonflux.io	FLUX 市场汇率

安全说明

• 私钥保留在服务进程中。工具不会返回任何已配置的密钥；flux_generate_keys 只返回它刚创建的密钥。
• 除非调用工具时设置 confirm=true，否则不会产生任何花费。会在调用工具前征求确认的宿主会在参数上下文中显示 USD 金额。
• FluxOS 会话是自行签发的签名短语，有效期为数小时；任何地方都不会存储密码或令牌。
• 使用专用支付地址，其中只存放你打算花费的金额。

开发

yarn install
yarn type-check && yarn lint && yarn format:check && yarn build && yarn test
yarn test:live      # differential test of the USD estimator against the network

USD 估算器、规范格式化器和共识守卫均与 FluxOS 代码（appSpecHelpers.js、appUtilities.js、messageVerifier.js）保持一致，实时测试会在每次运行时将估算器与网络进行核对。

许可证

MIT