vtimestamp

vtimestamp-mcp

Verus ブロックチェーン上の vtimestamp の証明を検証・照会する MCP サーバーです。

AI エージェント（Claude Desktop、VS Code など）が、VerusID 上のドキュメントのタイムスタンプを検証し、すべてのタイムスタンプを一覧表示できるようにします。ブロックチェーンから直接取得します。

書き込みサーバーをお探しですか？ vtimestamp-mcp-write をご覧ください。ローカルデーモンと、そのアイデンティティの秘密鍵を持つウォレットが必要です。

インストール

Claude Code

claude mcp add --transport stdio --scope user vtimestamp-read -- npx vtimestamp-mcp@latest

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "vtimestamp": {
      "command": "npx",
      "args": ["-y", "vtimestamp-mcp@latest"]
    }
  }
}

yarn を使用する場合：

{
  "mcpServers": {
    "vtimestamp": {
      "command": "yarn",
      "args": ["dlx", "vtimestamp-mcp"]
    }
  }
}

pnpm を使用する場合：

{
  "mcpServers": {
    "vtimestamp": {
      "command": "pnpm",
      "args": ["dlx", "vtimestamp-mcp"]
    }
  }
}

VS Code

VS Code の MCP 設定に追加します。

{
  "mcp": {
    "servers": {
      "vtimestamp": {
        "command": "npx",
        "args": ["-y", "vtimestamp-mcp@latest"]
      }
    }
  }
}

ツール

vtimestamp_verify

ファイルまたはテキストに VerusID 上のタイムスタンプが付与されているかを検証します。ファイルパスまたはテキストを指定すると、サーバーが SHA-256 ハッシュを計算し、オンチェーンの記録と照合します。

パラメーター	型	必須	説明
identity	string	はい	VerusID 名（例：alice@）
file_path	string	いずれか	検証するファイルのパス
text	string	いずれか	検証するテキスト文字列

file_path または text のどちらかを指定する必要があります（相互排他的です）。

プロンプトの例：

• 「/path/to/report.pdf にあるファイルに alice@ 上でタイムスタンプが付与されているか確認して」
• 「このテキストに bob@ 上でタイムスタンプが付与されているか検証して：請求書 #4521 が承認されたことを証明します」

vtimestamp_list

VerusID に記録されたすべてのタイムスタンプを一覧表示します。

パラメーター	型	必須	説明
identity	string	はい	VerusID 名（例：alice@）

例：「alice@ がタイムスタンプを付与したドキュメントは何ですか？」

vtimestamp_info

vtimestamp サービスに関する情報を取得します。

パラメーターはありません。

例：「vtimestamp とは何ですか？」

仕組み

デフォルトでは、サーバーは公開 Verus メインネットの RPC エンドポイントにクエリを送信します。ウォレット、API キー、認証は不要です。

AI Agent (Claude Desktop, VS Code, etc.)
    │ stdio (JSON-RPC)
    ▼
vtimestamp-mcp (local)
    │ HTTPS (JSON-RPC 1.0)
    ▼
Public Verus Mainnet RPC (rpc.vrsc.syncproof.net, fallback api.verus.services)

このサーバーを独自のデーモンに接続することもできます。公開 RPC で復号に対応していないテストネット、大量のリクエストを処理するエージェント、カスタムチェーン、または検査の結果を公開 RPC に送信したくない場合に便利です。以下の設定をご覧ください。

オンチェーンの保存形式

vtimestamp は VerusID の contentmultimap に保存され、getidentityhistory を介して読み取られます（updateidentity ごとに履歴エントリーが 1 つあります）。このサーバーは、次の 2 種類のオンチェーン形式を透過的に処理します。

• 公開暗号化（flags: 13、[email protected]+ で書き込み） — デーモンの {data:{}} エンベロープにより、epk と ivk がオンチェーンで公開された単一の暗号化 DataDescriptor が生成されます。読み取りには decryptdata、元の txid、および retrieve: true が必要です。IVK はオンチェーンにあるため（公開暗号化モード）、誰でも復号できます。鍵の共有は不要です。
• 従来の平文形式（flags: 0、[email protected] 以前で書き込み） — ラベル付きキーの下に、フィールドごとの DataDescriptor（sha256、title、description、filename、filesize）が保存されます。decryptdata を使わずに直接読み取れます。

リーダーは各エントリーのフラグに応じて処理を切り替えます。従来の書き込みによる古いエントリーと新しい暗号化エントリーが混在するアイデンティティも正しく処理され、どちらも vtimestamp_list の出力に表示されます。

背景については、アイデンティティに暗号化データを公開する方法をご覧ください。

パブリック RPC の要件

decryptdata はデーモンの RPC メソッドであり、すべてのパブリック Verus RPC で許可されているわけではありません。執筆時点では次のとおりです。

エンドポイント	チェーン	decryptdata	備考
https://rpc.vrsc.syncproof.net	VRSC メインネット	✅ 有効	このサーバーのプライマリーエンドポイントです。
https://api.verus.services	VRSC メインネット	❌ 無効	フォールバックのみです。暗号化されたエントリーはここでは復号に失敗しますが、従来の平文の読み取りは引き続き機能します。
https://api.verustest.net	VRSCTEST	❌ 無効	パブリックテストネット RPC で decryptdata をサポートしているものはありません。テストネットで暗号化されたデータを読み取るには、ローカルデーモンが必要です。

syncproof に接続できず、呼び出しが api.verus.services にフォールバックした場合、暗号化されたエントリーはクラッシュを起こすことなく、復号できないものとして表示されます。

設定

パブリック RPC をデフォルトで使用する場合、設定は不要です。サーバーを独自のデーモンに接続するには（テストネットでは必須、大量利用では推奨）、環境変数を設定してください。

環境変数

すべて任意です。いずれかを設定すると、サーバーはパブリック RPC モードからローカルデーモンモードに切り替わります。

変数	説明
VERUS_RPC_URL	デーモンの RPC URL（メインネットの場合は http://127.0.0.1:27486、テストネットの場合は http://127.0.0.1:18843 など）
VERUS_CONF_PATH	VRSC.conf / vrsctest.conf ファイルへのパス。URL（http://127.0.0.1:<rpcport>）と認証情報を自動的に導出します。
VERUS_RPC_USER	上書き：RPC ユーザー名
VERUS_RPC_PASSWORD	上書き：RPC パスワード

動作：

• (環境変数なし) → パブリック RPC の組み合わせ（プライマリーは rpc.vrsc.syncproof.net、フォールバックは api.verus.services）。メインネットのみです。
• VERUS_RPC_URL を設定 → その URL の単一ローカルエンドポイントを使用します。認証情報は VERUS_RPC_USER と VERUS_RPC_PASSWORD から取得します。これらが設定されていない場合は、VERUS_CONF_PATH から自動的に導出します。
• VERUS_CONF_PATH を設定（VERUS_RPC_URL は未設定）→ 設定ファイルから URL（http://127.0.0.1:<rpcport>）を取得し、認証情報も設定ファイルから取得します。

ローカルデーモンの例（テストネット）

{
  "mcpServers": {
    "vtimestamp": {
      "command": "npx",
      "args": ["-y", "vtimestamp-mcp@latest"],
      "env": {
        "VERUS_CONF_PATH": "/Users/you/Library/Application Support/Komodo/vrsctest/vrsctest.conf"
      }
    }
  }
}

または、すべてを明示的に指定します。

{
  "mcpServers": {
    "vtimestamp": {
      "command": "npx",
      "args": ["-y", "vtimestamp-mcp@latest"],
      "env": {
        "VERUS_RPC_URL": "http://127.0.0.1:18843",
        "VERUS_RPC_USER": "rpc-user-from-conf",
        "VERUS_RPC_PASSWORD": "rpc-password-from-conf"
      }
    }
  }
}

要件

• Node.js 18+
• デフォルトの動作：ほかに必要なものはありません。パブリックメインネット RPC を使用します。
• テストネットまたはローカルデーモンモード：接続先ホストで verusd（または verusd -chain=vrsctest）が実行されていること。

ライセンス

MIT