Exergynet

exergynet-mcp-server

用于查询 Solana 上 ExergyNet LNES-03 计划的只读 MCP 查询工具，另附本地计算成本估算器。它是 ExergyNet 的一部分。ExergyNet 是与模型无关的基础设施，用于持久化记忆、受治理的执行和可验证的结算 — 详情请见 exergynet.org。

安全公告（2026-08-28）

此软件包的早期版本（包括 0.2.2 在内的所有版本）包含可正常使用的 exergynet_open_job 工具：用户配置真实钱包后，该工具会向一个合约地址发送真实的 Base Mainnet 交易，其中包括无条件、无限额的 USDC 花费授权。ExergyNet 自己的状态页已将该合约地址标记为已退役，且其访问控制无法独立验证。 没有证据表明任何独立（非开发者）钱包曾使用此路径。完整详情见 exergynet-site 仓库中的 MCP_SECURITY_ADVISORY_2026-08-28.md。

从 0.2.3 开始，exergynet_open_job 已禁用。 它始终会返回故障时关闭的提示，并且在任何配置下都不会构建、签署或提交交易。此版本完全不含签名依赖（已移除 ethers 和 viem），也不会读取或要求提供任何私钥。0.2.4 还修复了独立 MCP 安全扫描发现的输入验证和审计日志记录缺陷 — 详情见下文。

如果你安装过 0.2.3 之前的版本并配置了真实的 BASE_PRIVATE_KEY，请撤销你可能授予地址 0x5cfE075149776f4b3cca07a27D4fd85A60BA5e3f 的任何 USDC 授权（例如通过 revoke.cash），并立即升级。

独立安全扫描整改（0.2.4）

MCP Vouch 曾按照 OWASP MCP Top 10 对早期构建版本（0.1.10）进行独立扫描，得分为 71/100（C 级），并发现四项警告：输入验证、审计/遥测、速率限制和供应链风险。0.2.4 已针对当前工具集解决全部四项问题：

• 输入验证： exergynet_estimate_gate 和 exergynet_verify_program 现在会拒绝非有限、负数或格式错误的输入，并清晰地报告错误，而不是静默强制转换。
• 审计/遥测： 每次工具调用都会将时间戳和执行结果记录到 stderr。
• 速率限制： exergynet_verify_program（唯一会发起出站网络调用的工具）限制为每 10 秒最多调用 20 次。
• 供应链： 已在 0.2.3 中移除 ethers/viem。0.2.4 中已通过 npm audit fix 修复传递依赖 ws 的漏洞。剩余的中等严重性 uuid 安全公告（可经由 @solana/web3.js → jayson → [email protected] 触达）已在 0.2.5 中解决：添加有针对性的 overrides 条目，将 jayson 的 uuid 依赖固定为 ^11.1.1，且无需降级 @solana/web3.js 本身。此更改后，npm audit 报告的漏洞数为 0。修复经过验证，绝非盲目应用：完整重建、全部 9 项回归测试通过，并通过 exergynet_verify_program 对 Solana Mainnet-Beta 进行实时网络调用，确认该覆盖项不会改变 RPC 行为。

发布新版本后，我们将请求进行一次新的独立复扫；届时会记录新旧结果，而不会悄悄删去 71/100 的分数。

---

此软件包的用途

exergynet-mcp-server 是结算层 MCP 服务：提供只读的 LNES-03 Solana 程序查询，以及本地计算成本估算器。它是接入更广泛 ExergyNet 体系的一种接口。

ExergyNet 是面向自主 AI 系统的模型无关基础设施，提供持久化记忆、受治理的执行和可验证结算。三个主要接口如下：

接口	软件包	提供的功能
本地持久化记忆	@lnes/vanguard-memory-node	BM25 搜索、SHA-256 寻址分片存储、xLMP 有界召回（在约 1000 万 token 的语料库中验证，平均 K ≈ 896 token）
结算层（本软件包）	exergynet-mcp-server	只读 LNES-03 Solana 查询 + 计算成本估算器；写入结算（exergynet_open_job）已禁用，待迁移至 Base L2
权限门控	LNES-22（独立服务）	后果授权、委派收据、经红队验证的拒绝逻辑

如果你需要为 AI Agent 提供本地持久化记忆，请安装 @lnes/vanguard-memory-node。如果你需要查询 LNES-03 程序状态或估算计算成本，请安装本软件包。

---

快速安装

npx -y exergynet-mcp-server

Claude Code

claude mcp add --transport stdio exergynet -- npx -y exergynet-mcp-server

Claude Desktop / ElizaOS / 其他 MCP 客户端

{
  "mcpServers": {
    "exergynet": {
      "command": "npx",
      "args": ["-y", "exergynet-mcp-server"]
    }
  }
}

本服务不需要也不接受私钥或钱包凭据。 RPC_URL 为可选项，默认使用 Solana Mainnet-Beta 公共端点。

---

工具

工具	功能	是否调用网络？	是否能转移资金或签署任何内容？
exergynet_get_program_id	返回 LNES-03 Solana 程序 ID	否 — 静态值	否
exergynet_verify_program	只读检查 Solana 上的 LNES-03 程序账户是否存在且可执行	是 — 一次只读 RPC 调用（限流：20/10s）	否
exergynet_get_proof_transaction	返回一笔参考 LNES-03 结算交易签名	否 — 静态值	否
exergynet_estimate_gate	本地算术运算：将外部计算成本与结算成本 + 风险边际进行比较	否 — 仅本地算术运算	否
exergynet_open_job	已禁用。 始终返回安全关闭消息（安全公告 2026-08-28）	否	否 — 此版本不具备签名能力

写入工具的成熟度

在当前 Base L2 执行目标经过独立端到端验证之前，exergynet_open_job 将继续保持禁用状态。验证内容包括：正确的链 ID、正确的合约身份、匹配的 ABI，以及有效的结算路径（由真实证明者生成 settleExergy 所需的 ZK 收据）；并且该验证结果必须公开记录。重新启用该工具的版本将明确说明其目标合约，以及调用者如何在任何交易成为可能之前独立确认该合约。在此之前：本软件包中的 ExergyNet MCP 工具绝不会要求提供私钥或发送交易。

如需查看当前经过验证的 Base L2 合约地址和结算状态，请参阅 exergynet.org/proof.html。

---

机器发现

ExergyNet 的设计目标是让 AI Agent 能够发现它，而不是供人类浏览文档页面。

• 知名端点： https://exergynet.org/.well-known/exergynet.json — 功能清单
• LLMs.txt： https://exergynet.org/llms.txt — 可供模型读取的协议说明
• MCP 服务卡片： https://exergynet.org/.well-known/mcp/server-card.json
• MCP Registry： io.github.ezumba/exergynet

---

权限边界

AI 可以提出后果，但不能授权自身造成的后果。

后果边界（LNES-22）在架构上与此服务分离。此软件包提供只读的程序查询和本地成本估算器。重新启用 exergynet_open_job 后，它只会在你明确授予的支出权限范围内运行——模型层永远不会持有可用于执行重大操作的签名凭据。

有关 x402 攻击类别分析和 ExergyNet 的架构控制，请参阅 SECURITY.md。

---

兼容的 Agent

• Claude（Claude Code、Claude Desktop）
• ElizaOS
• 任何兼容 MCP 的 Agent 运行时

---

链接

• exergynet.org
• npm：exergynet-mcp-server
• npm：@lnes/vanguard-memory-node — 配套的本地记忆软件包
• GitHub
• MCP Registry — io.github.ezumba/exergynet
• 白皮书
• 基准测试

---

许可证

MIT © ezumba