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 能力的開發者:這個 repo 是該網路的 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 等),並將 repo 複製(clone)到本機。以下是官方 README 提供的最直接路徑。
  • 安裝與設定:repo 提供 tools/platform/cli 底下的開發者 CLI,透過 layerx install mcp 即可安裝 MCP 傳輸(另有 layerx install a2a 可安裝 A2A 傳輸,屬次要方式)。這一步是官方建議的設定主路徑。
  • 首次低風險驗證:從 repo 根目錄執行 make layerxd 與 make layerxctl,分別建置 LayerX 核心守護程序與其操作 CLI(make paxeer-build 則建置 build/paxd)。建置輸出就是第一個成功訊號。
  • 成功訊號:核心與 CLI 的建置產物產生、layerx install mcp 完成後,MCP 用戶端中出現 LayerX 的 MCP server。注意:證據未提供具體的 CLI 子命令清單或工具呼叫範例,目前能確認到「安裝傳輸 + 建置成功」這一步;更深入的呼叫細節請以 repo 內文件為準,不要憑空猜測參數。
  • 提醒:以上都屬於本機狀態寫入(編譯產物、本機設定),不是遠端寫入操作;但也不能視為「零風險」——本機讀寫、網路存取等隱私邊界未有證據說明。

使用案例

  • 案例一:把 LayerX agent 的 MCP 傳輸裝進你的 MCP 用戶端。在 tools/platform/cli 的 CLI 中執行 layerx install mcp,完成後在你設定的 MCP 用戶端裡查看是否出現該 server 及其工具清單。證據只支持確認到「傳輸已安裝、server 出現」;具體工具名稱與參數在已採用的證據中官方並未列出,請以 repo 文件的實際輸出為準。
  • 案例二:為本機開發建置核心與操作工具鏈。複製 repo 後從根目錄執行 make layerxd 和 make layerxctl,得到 LayerX 核心守護程序與操作 CLI;如果你同時想建置鏈節點,執行 make paxeer-build 得到 build/paxd。可以期待的結果是建置命令成功產出對應的二進位檔。涉及實際部署或資產的操作不在這個範圍內。

使用邊界

  • 建置與本機設定屬於本機狀態寫入;make public-audit(即 scripts/ci/public-repo-audit.sh)是每次變更都必須通過的檢查,但官方明確表示:本機通過稽核不等於授權部署合約、轉移託管或處理真實資產——任何這類遠端寫入操作都需要額外的官方確認流程,證據未提供該流程細節。
  • 憑證、錢包、API key 等設定要求在已採用的證據中並未說明,不要在第一次嘗試時預先提供敏感資訊;確有需要時以官方文件為準。
  • 尚未確認的關鍵資訊:MCP server 暴露的具體工具清單與參數、執行埠、用戶端相容範圍、唯讀工具的隱私與連網邊界,均未在證據中出現,使用前請直接核對 repo 文件。
  • readOnlyHint 這類唯讀工具即使存在,也只代表不執行寫入操作,不代表不會連網或讀取本機資料;不應據此做出整體安全結論。