chain

VerusIDX MCP 服务

7 个 MCP 服务，让 AI Agent 可直接在本地访问 Verus 区块链——49 个工具，零云端依赖。无需 API 密钥，无需账户，Agent 与区块链之间没有中介。

适用于 Claude Code、Cursor 及任何兼容 MCP 的客户端。

Agent 可以做什么？

• 身份 — 创建、更新、撤销和恢复 VerusID（协议级区块链身份，支持链上数据存储）
• 数据 — 存储、检索和解密链上数据；使用 SHA-256、Blake2b、Keccak-256 或 Merkle Mountain Range 证明进行签名和验证；通过查看密钥共享解密访问权限
• 发送与兑换 — 转移货币，通过分数篮子兑换，以及通过 PBaaS 桥进行跨链转账
• 创建货币 — 定义代币、分数储备篮子、中心化货币和 ERC-20 映射代币
• 交易 — 在链上进行货币对货币、货币对身份或身份对身份的原子交换
• 隐私 — 通过 Sapling 零知识证明进行屏蔽交易

快速开始

前提条件： 正在运行的 Verus 守护进程和 Node.js 18+。

将基础服务添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "verusidx-chain": {
      "command": "npx",
      "args": ["-y", "@verusidx/chain-mcp"]
    }
  }
}

然后让 AI 调用 refresh_chains——它会自动发现本地守护进程。就这么简单。

无需单独安装——npx 会按需获取并运行该包。根据需要添加更多服务（见下文）。

服务

Package	工具	用途
@verusidx/chain-mcp	11	基础服务 — 区块链发现、守护进程管理、健康检查、货币查询、原始交易、RPC 帮助
@verusidx/identity-mcp	11	创建、管理和查询 VerusID
@verusidx/send-mcp	8	发送、兑换和转移货币；检查余额和兑换情况
@verusidx/data-mcp	7	检索、解密、签名和验证链上数据；管理查看密钥
@verusidx/address-mcp	6	生成、验证和列出透明地址与屏蔽地址
@verusidx/marketplace-mcp	5	链上报价与交易
@verusidx/definecurrency-mcp	1	定义并启动新货币

chain-mcp 是基础服务。 它会发现正在运行的守护进程，并写入供所有其他服务读取的注册表文件。请先安装它。每个工具都需要 chain 参数（例如 "VRSC"、"vrsctest"）——没有默认区块链。

添加更多服务

每个服务彼此独立——添加或移除其中一个不会影响其他服务：

{
  "mcpServers": {
    "verusidx-chain": {
      "command": "npx",
      "args": ["-y", "@verusidx/chain-mcp"]
    },
    "verusidx-identity": {
      "command": "npx",
      "args": ["-y", "@verusidx/identity-mcp"]
    },
    "verusidx-send": {
      "command": "npx",
      "args": ["-y", "@verusidx/send-mcp"]
    },
    "verusidx-data": {
      "command": "npx",
      "args": ["-y", "@verusidx/data-mcp"]
    }
  }
}

@verusidx/address-mcp、@verusidx/marketplace-mcp 和 @verusidx/definecurrency-mcp 也采用相同方式。详情请参阅各软件包的 README。

安全

让 AI Agent 访问钱包会带来实际影响。这些服务的设计充分考虑了这一点。

功能	工作方式
只读模式	为每个服务设置 VERUSIDX_READ_ONLY=true — 写入工具不仅会被禁用，还不会注册。AI 无法看到或尝试使用这些工具。
支出限额	在 spending-limits.json 中设置每种货币的限额，并在 RPC 调用到达守护进程之前强制执行。默认值：每笔交易 10 VRSC。
审计日志	每项写入操作都会记录到带日期标记、仅追加的 JSONL 文件中，权限为 0600。
不增加攻击面	凭据从守护进程自己的 .conf 文件中读取。不使用云存储。不使用包含密码的环境变量。
最少依赖项	共享库没有任何运行时依赖项。MCP 服务恰好依赖 2 个软件包：@modelcontextprotocol/sdk 和 zod。

架构

AI Client (Claude Code, Cursor, etc.)
    |
    |  stdio (local process, no network)
    v
verusidx MCP servers (7 servers, 49 tools)
    |
    |  JSON-RPC over localhost
    v
verusd (your local Verus daemon)

• 共享库（@verusidx/shared）— 注册表读取器、带凭据缓存的 RPC 客户端、错误规范化、审计日志记录、支出限额、只读保护。没有任何运行时依赖项。
• 链注册表 — 由 chain-mcp 原子写入 chains.json，其他所有服务通过基于 stat() 的缓存失效机制读取。
• 每个服务都通过 stdio 传输作为独立进程运行。 服务之间不共享内存。

配置

可设置的环境变量（可选）：

变量	适用对象	描述
VERUSIDX_READ_ONLY	所有服务	设置为 true 以禁用写入工具。按服务设置可进行精细控制。
VERUSIDX_AUDIT_LOG	所有服务	设置为 false 以禁用审计日志（默认：启用）
VERUSIDX_AUDIT_DIR	所有服务	自定义审计日志目录
VERUSIDX_SPENDING_LIMITS_PATH	所有服务	自定义 spending-limits.json 的路径
VERUSIDX_DATA_DIR	chain-mcp	覆盖用于发现的链数据目录
VERUSIDX_EXTRA_CHAINS	chain-mcp	添加远程守护进程。格式：name:host:port:user:pass，以逗号分隔
VERUSIDX_BIN_PATH	chain-mcp	包含 verusd 二进制文件的目录（如果该文件不在 PATH 中）

支出限额

发送资金的服务（send-mcp、marketplace-mcp）会强制执行每种货币的支出限额。首次运行时会自动创建默认的 spending-limits.json：

{
  "VRSC": 10
}

这样会将任何单次 sendcurrency 调用的金额限制为 10 VRSC。要调整限额，请编辑以下位置的文件：

• macOS： ~/Library/Application Support/verusidx-mcp/spending-limits.json
• Linux： ~/.config/verusidx-mcp/spending-limits.json
• Windows： %APPDATA%\verusidx-mcp\spending-limits.json

为任意货币添加条目：{ "VRSC": 100, "Bridge.vETH": 0.5 }。货币名称不区分大小写。

开发

# Prerequisites: Node.js >= 18, pnpm
pnpm install
pnpm -r build              # build all packages
pnpm -r test               # test all packages

# Build a specific server and its dependencies
pnpm --filter @verusidx/chain-mcp... build

项目结构

verusidx-mcp/
├── packages/
│   ├── shared/          # @verusidx/shared — internal library
│   ├── chain/           # @verusidx/chain-mcp — foundation server
│   ├── identity/        # @verusidx/identity-mcp
│   ├── send/            # @verusidx/send-mcp
│   ├── data/            # @verusidx/data-mcp
│   ├── definecurrency/  # @verusidx/definecurrency-mcp
│   ├── marketplace/     # @verusidx/marketplace-mcp
│   └── address/         # @verusidx/address-mcp
└── tool-specs/          # Agent-facing tool description specs

供应链安全

• 共享库没有任何运行时依赖项（Node 内置模块 + 内置 fetch）
• MCP 服务仅依赖 @modelcontextprotocol/sdk 和 zod
• onlyBuiltDependencies: [] 会阻止依赖项安装脚本运行
• 所有凭据均从守护进程的 .conf 文件中读取 — MCP 服务绝不存储凭据

关于 Verus

Verus 是一个开源、公平启动的区块链 — 没有 ICO、没有预挖，也没有 VC 融资。该项目自 2018 年起运行，采用混合 PoW/PoS 共识和可通过 CPU 挖矿的哈希算法（VerusHash 2.2）。

Verus 没有智能合约。身份、数据存储、DeFi 转换、原子交换、隐私（Sapling zk-proofs）和跨链桥（PBaaS）都是共识层协议功能。对于需要可靠交易的 AI Agent，协议层保障优于合约层保障。

许可证

MIT