identity

VerusIDX MCP サーバー

AI エージェントに Verus ブロックチェーンへの直接かつローカルなアクセスを提供する 7 つの MCP サーバーです。49 個のツール、クラウド依存ゼロ。API キーは不要です。アカウントも不要です。エージェントとブロックチェーンの間に仲介者はいません。

Claude Code、Cursor、および MCP 互換のあらゆるクライアントで動作します。

エージェントでできること

• アイデンティティ — VerusID（オンチェーンのデータストレージを備えた、プロトコルレベルのブロックチェーン ID）の作成、更新、取り消し、復旧
• データ — オンチェーンデータの保存、取得、復号；SHA-256、Blake2b、Keccak-256、または Merkle Mountain Range 証明による署名と検証；閲覧キーによる復号アクセスの共有
• 送金と変換 — 通貨の移動、分割バスケットを介した変換、PBaaS ブリッジ経由のクロスチェーン送金
• 通貨の作成 — トークン、分割準備金バスケット、中央集権型通貨、ERC-20 マッピングトークンの定義
• 取引 — 通貨同士、通貨と ID、または ID 同士のオンチェーン原子交換
• プライバシー — Sapling ゼロ知識証明によるシールド取引

クイックスタート

前提条件： 起動中の Verus デーモン と Node.js 18 以降。

MCP クライアントの設定に基盤サーバーを追加します。

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

次に、AI に refresh_chains を呼び出すよう指示します。ローカルのデーモンが自動的に検出されます。これだけです。

別途インストールする必要はありません。npx が必要に応じてパッケージを取得し、実行します。必要に応じてサーバーを追加してください（以下を参照）。

サーバー

パッケージ	ツール	用途
@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 エージェントにウォレットへのアクセスを許可すると、実際の影響が生じます。これらのサーバーは、その点を考慮して設計されています。

機能	仕組み
読み取り専用モード	サーバーごとに VERUSIDX_READ_ONLY=true を設定します。書き込みツールは単に無効化されるのではなく、登録されません。AI からは見えず、使用も試みられません。
支出上限	spending-limits.json で通貨ごとの上限を設定し、RPC 呼び出しがデーモンに届く前に適用します。デフォルトは取引ごとに 10 VRSC です。
監査ログ	すべての書き込み操作は、日付入りの追記専用 JSONL ファイルに 0600 の権限で記録されます。
新たな攻撃対象領域なし	認証情報はデーモン自身の .conf ファイルから読み取ります。クラウドストレージは使用せず、パスワードを含む環境変数も使用しません。
最小限の依存関係	共有ライブラリに実行時依存関係はありません。MCP サーバーの依存パッケージは @modelcontextprotocol/sdk と zod の 2 つだけです。

アーキテクチャ

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 クライアント、エラーの正規化、監査ログ、支出上限、読み取り専用ガードを提供します。実行時依存関係はありません。
• チェーンレジストリ — chains.json は chain-mcp がアトミックに書き込み、ほかのすべてのサーバーは 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 からの資金調達を行わない、オープンソースの公平なローンチを実現したブロックチェーンです。ハイブリッド PoW/PoS コンセンサスと、CPU でマイニング可能なハッシュアルゴリズム（VerusHash 2.2）を採用し、2018 年から稼働しています。

スマートコントラクトはありません。アイデンティティ、データストレージ、DeFi 変換、アトミックスワップ、プライバシー（Sapling zk-proof）、クロスチェーンブリッジ（PBaaS）は、すべてコンセンサスレベルのプロトコル機能です。確実な取引を必要とする AI エージェントにとって、プロトコルレベルの保証はコントラクトレベルの保証より優れています。

ライセンス

MIT