MCP

layerx-mcp:接入 Paxeer X LayerX agent 的 MCP server 入门

如果你要在本地从源码接入 Paxeer X 的 LayerX agent MCP server,先备齐 Go/C17/Rust 工具链再用官方 CLI 安装,否则构建这一步就会卡住。

官方来源 · GitHub - Sidiora-Labs/paxeer-monorepo

安装

layerx install mcp

适合谁

  • 适合想在 Paxeer X Network 生态里接入 agent 能力的开发者:这个仓库是该网络的 monorepo,包含 Paxeer X 链(paxd,Go,EVM chain ID 125)与 LayerX 内核(layerxd,C17,面向自主 agent 的确定性执行与记账域),并附带了位于 services/agent/crates/layerx-mcp 的 MCP server,以及 Rust、Python、TypeScript SDK。
  • 适合已经准备从源码构建的开发环境:官方列出的工具链要求包括 Go 1.25.8(go.mod)、内核所需的 C17 编译器、Rust 1.91.1(rust-toolchain.toml)、Solidity 0.8.27 与 Foundry,以及 Node.js(npm workspaces)。
  • 不适合只想装一个独立 MCP 包、不做本地构建的用户:证据未提供任何预编译二进制或托管服务说明。对链上部署、资产托管等操作,官方明确说明本地通过审计并不授权这些行为;除此之外的具体权限边界证据未说明。

3 分钟完成第一次尝试

  • 前提:按官方要求准备工具链(Go 1.25.8、C17 编译器、Rust 1.91.1、Node.js 等),并克隆该仓库到本地。以下是官方 README 给出的最直接路径。
  • 安装与配置:仓库提供 tools/platform/cli 下的开发者 CLI,通过 layerx install mcp 即可安装 MCP 传输(另有 layerx install a2a 安装 A2A 传输,属次要方式)。这一步是官方推荐的配置主路径。
  • 首次低风险验证:从仓库根目录运行 make layerxd 与 make layerxctl,分别构建 LayerX 内核守护进程与其操作 CLI(make paxeer-build 则构建 build/paxd)。构建输出是首个成功信号。
  • 成功信号:内核与 CLI 构建产物生成、layerx install mcp 完成后 MCP 客户端中出现 LayerX 的 MCP server。注意:证据未给出具体的 CLI 子命令列表或工具调用示例,能确认到"安装传输 + 构建成功"这一步;再深入的调用细节请以仓库内文档为准,不要凭空猜测参数。
  • 提醒:以上均属本地状态写入(编译产物、本地配置),不是远端写操作;但也不能当作"零风险"——本地读写、网络访问等隐私边界证据未说明。

使用案例

  • 案例一:把 LayerX agent 的 MCP 传输装进你的 MCP 客户端。在 tools/platform/cli 的 CLI 中执行 layerx install mcp,完成后在你配置的 MCP 客户端里查看是否出现该 server 及其工具列表。证据只支持确认到"传输已安装、server 出现";具体工具名与参数官方未在已采证据中列出,请以仓库文档实际输出为准。
  • 案例二:为本地开发构建内核与操作工具链。克隆仓库后从根目录运行 make layerxd 和 make layerxctl,得到 LayerX 内核守护进程与操作 CLI;如果你同时想构建链节点,运行 make paxeer-build 得到 build/paxd。可期待的结果是构建命令成功产出对应二进制。涉及真实部署或资产的动作不在此范围内。

使用边界

  • 构建与本地配置是本地状态写入;make public-audit(即 scripts/ci/public-repo-audit.sh)是每次改动必须通过的检查,但官方明确:本地通过审计不等于授权部署合约、转移托管或处理真实资产——任何此类远端写操作都需额外的官方确认流程,证据未给出该流程细节。
  • 凭证、钱包、API key 等配置要求在已采证据中未说明,不要在首次尝试时预先提供敏感信息;确需时以官方文档为准。
  • 尚未确认的关键信息:MCP server 暴露的具体工具清单与参数、运行端口、客户端兼容范围、只读工具的隐私与联网边界,均未在证据中出现,使用前请直接核对仓库文档。
  • readOnlyHint 类只读工具即使存在,也只代表不执行写操作,不代表不会联网或读取本地数据;不应据此作出整体安全结论。