ElysiumForge-Labs/elysium-chain-mcp

项目介绍

Elysium Chain MCP 是一个 TypeScript 编写的 MCP 服务器，让 AI 代理接入 Elysium——Kinetiq 为 Hyperliquid 构建的 Arbitrum Orbit L2。代理可以通过 JSON-RPC 读取区块、交易、余额、代币信息和事件日志，还能调用合约的 view/pure 函数；配置区块浏览器 API 后，也可以查询浏览器数据。写操作默认不注册，只有设置 ENABLE_WRITES=true 且链 ID 为 99801（Elysium 测试网）时才会启用。

项目自称非官方社区项目，与 Kinetiq/Hyperliquid 没有隶属关系。

快速使用

需要 Node.js 20 或更高版本。最直接的方式是在 MCP 客户端配置中加入服务器。Claude Desktop（claude_desktop_config.json）和 Cursor（mcp.json）都使用同一个 mcpServers 对象：

{
  "mcpServers": {
    "elysium": {
      "command": "npx",
      "args": ["-y", "elysium-chain-mcp"],
      "env": {
        "ELYSIUM_RPC_URL": "https://testnet-rpc.elysium.kinetiq.xyz",
        "ELYSIUM_CHAIN_ID": "99801"
      }
    }
  }
}

这里的 RPC 地址和链 ID 是链规格中公布的公共测试网值。默认传输方式为 stdio，进程从客户端读取环境变量，不加载 .env 文件。

本地检出后，先导出 ELYSIUM_RPC_URL 和 ELYSIUM_CHAIN_ID，再依次运行 npm install、npm run build 和 npm start。若要改用 HTTP，设置 MCP_TRANSPORT=http，进程绑定 127.0.0.1:3000，接受 POST /mcp，GET /health 用于健康检查。首次连接和示例提示词可参考项目的 Start here 指南 与 Examples。

工具与配置

八个读工具始终注册，覆盖链状态、区块查询、交易与回执、HYPE 及最多 20 个 ERC-20 余额、代币信息、合约只读调用、事件日志，以及返回 eth_call 和 gas 估算的 simulate_call。无过滤条件的日志查询默认限制为 2,000 个区块，可通过 MAX_LOG_BLOCK_RANGE 调整。

设置 EXPLORER_API_URL 后额外注册七个浏览器工具。它们调用未公开的 Blockscout 风格 API，索引数据可能落后于链上状态，因此 RPC 工具被视为准确来源；浏览器返回的名称、符号、ABI 和源码会被标记为 untrusted。

启用 ENABLE_WRITES=true 后会注册 send_native 和 write_contract 两个写工具，默认 dry_run: true，即只模拟并返回交易而不签名；把 dry_run 设为 false 才会签名并提交。完整变量清单见 .env.example，超时、重试、限速和传输配置在 README 配置表中列出。

使用约束

写操作仅限测试网：链 ID 不是 99801、私钥无效，或 HTTP 模式下缺少至少 16 字符的 MCP_HTTP_TOKEN 时，服务器不会启用写工具。每笔写操作会依次检查可选的 WRITE_ALLOWLIST、转账金额上限（MAX_SEND_HYPE，默认 0.01 HYPE）、节点报告的链 ID、eth_call 是否成功、手续费上限（MAX_FEE_HYPE，默认 0.001 HYPE）以及账户余额，全部通过才会提交。

dry_run 只是预览，代理可以自行传入 dry_run: false，因此项目建议对两个写工具保持 MCP 客户端的工具调用审批。应使用专用测试网账户，从 测试网水龙头 获取资金，并且只放可以承受损失的资产。ELYSIUM_PRIVATE_KEY 会从进程环境读取后移除，但提供该变量的客户端配置或密钥文件仍然保存着私钥。

WRITE_ALLOWLIST 和 MAX_SEND_HYPE 只约束顶层交易；白名单中的代币合约仍可能被调用 transfer 或 approve 发往任意地址。浏览器文本和链上名称由第三方写入，可能试图诱导代理，同时开启浏览器和写操作时服务器会在启动时警告。发送状态为 pending 或 SEND_STATUS_UNKNOWN 时，交易可能已进入节点，应先用哈希查找再决定是否重发。

仓库未声明许可证。

HotRepo 点评

该项目在 HotRepo 新项目榜 2026 年 11 月 4 日的 TypeScript 语言视图中被记录，当时 108 stars，在约两小时的观察窗口内净增 7 stars，Fork 数为零。这个观察窗口很短，项目面向的群体也较窄：需要让 AI 代理只读访问 Elysium 测试网，或尝试受严格限制的写操作的人。其价值主要在于写操作周围的防护设计——仅限测试网、默认 dry run、金额与手续费上限、目标地址白名单——同时文档也明确承认白名单无法约束代币合约层面的 transfer 或 approve。是否启用写操作，读者应从这些限制出发判断。