RealAgent MCP

realagent-mcp

国信智能体实名关联服务 MCP Server — 单一実行ファイル · ローカル通信 · 国産暗号化 · 全プラットフォーム対応。

AI エージェントに、SM2 による実名アイデンティティの関連付け、SD-JWT 検証可能証明（VP）の生成と検証、SM2 暗号操作などの機能を提供します。

インストール

npm i -g realagent-mcp

グローバルにインストールする必要があります（-g）。これにより realagent-mcp が PATH に追加され、MCP 設定内の npx realagent-mcp がグローバルのコピーを参照するようになります。毎回 _npx キャッシュに再ダウンロードされることはありません （依存関係の重複と npx の古いキャッシュの問題を回避できます）。

MCP クライアントを設定します（--agent-id は必須です。各エージェントには一意の名前を使用してください）。

{
  "mcpServers": {
    "realagent-mcp": {
      "command": "npx",
      "args": ["-y", "realagent-mcp", "stdio", "--agent-id", "my-agent"]
    }
  }
}

アップグレード

npm update -g realagent-mcp
# 或
npm i -g realagent-mcp@latest

アップグレード後、MCP クライアントを再起動してください。エージェントは会話の開始時に system_update を自動的に呼び出して、新しいバージョンがあるか確認します。

機能

• SM2 鍵ペアの生成 — 国産暗号 SM2 による署名／署名検証／暗号化／復号
• 実名の関連付け — QR コードを生成 → スキャンして認証 → VC を自動取得
• VP の生成／検証 — SD-JWT 検証可能証明、W3C VC Data Model v2
• SM4 暗号化ストレージ — 秘密鍵と VC を SM4-CTR+SM3-HMAC でローカル暗号化
• 自動更新 — バージョン確認機能と system_update ツールを内蔵

ツール

MCP Server は実行時に以下の 14 個のツールを動的に公開します。

実名アイデンティティの関連付け

ツール	説明
identity_link	実名の関連付けを開始します。QR コードを生成し、ユーザーがスキャンして認証すると、実名資格情報（VC）を自動取得します
identity_status	現在のエージェントの実名関連付け状態とアイデンティティ情報を照会します
identity_revoke	実名の関連付けを解除し、資格情報を無効化します

検証可能証明（VP）

ツール	説明
identity_vp	SD-JWT 検証可能証明（VP）を生成します。フィールドの選択的開示に対応しています
identity_verify_vp	VP の署名と開示内容を検証します
vp_parse	VP の構造を解析し、開示されたクレームフィールドを抽出します

資格情報と鍵の照会

ツール	説明
vc_info	ローカルに取得済みの検証可能資格情報（VC）の概要情報を照会します
vc_raw	VC の生データを取得します
key_info	ローカルの SM2 鍵ペアとフィンガープリント情報を照会します

国産暗号演算

ツール	説明
crypto_sign	SM2 秘密鍵を使用してデータに署名します
crypto_verify	SM2 署名を検証します
crypto_encrypt	SM2 でデータを暗号化します
crypto_decrypt	SM2 でデータを復号します

システム

ツール	説明
system_update	MCP Server に新しいバージョンがあるか確認します

エージェントへの指示

以下の内容は AI エージェントが読み取り、インストールと設定を自動で完了するためのものです。

1. 前提条件 — Node.js を確認します（インストール前に必ず実行してください）。 realagent-mcp には Node.js >= 18.13 が必要です（npm と npx は Node.js に同梱されています）。 インストールの前に、環境を確認してください。

   • node --version と npm --version を実行します。両方が成功し、かつ node --version が >= v18.13 を報告する場合は、手順 2 に進みます。
   • node／npm が見つからない場合（Node.js がない場合）、またはバージョンが 18.13 より古い場合は、先に進まず、ユーザーがセットアップできるよう支援してください。
     • Windows：winget install OpenJS.NodeJS.LTS（PowerShell）、または https://nodejs.org から LTS インストーラーをダウンロードします。
     • macOS：brew install node@22、または nvm install --lts（nvm： https://github.com/nvm-sh/nvm）。
     • Linux：nvm install --lts（nvm： https://github.com/nvm-sh/nvm）、または使用しているディストリビューション向けの NodeSource リポジトリを利用します。
   • インストール／アップグレード後、ユーザーにターミナルと MCP クライアントを 再起動してもらい、node --version、npm --version、 npx --version で再確認します。3 つすべてのコマンドが成功し、 Node >= 18.13 が確認できてから、手順 2 に進んでください。

2. npm でインストールします（グローバルインストールにより、realagent-mcp が PATH に追加されます）。

   npm i -g realagent-mcp
   

3. MCP クライアントの設定 — 各エージェントに一意の --agent-id を必ず割り当ててください。 1 つの agent-id は 1 つのアイデンティティと 1 つの SM2 鍵ペアに対応します。エージェント間で agent-id を再利用しないでください。 realagent プラットフォームは各鍵ペアを個別のアイデンティティとして登録するため、agent-id を共有するとアイデンティティの競合が発生します。

   現在のプロジェクトまたはエージェントの目的に基づいて、説明的な名前を使って agent-id を生成してください（例：「my-claude-code」、 「frontend-dev-helper」、「pr-review-bot」）。小文字、数字、 ハイフンのみを使用してください。使用する前に、必ずユーザーに確認してください。

   realagent-mcp を agent-id：<name> で設定します。この名前は、 一意の SM2 アイデンティティの生成に使用されます。この設定でよろしいですか？ お好みの名前に変更することもできます。

   確認後、以下の MCP 設定を書き込みます。

   {
     "mcpServers": {
       "realagent-mcp": {
         "command": "npx",
         "args": [
           "-y",
           "realagent-mcp",
           "stdio",
           "--agent-id",
           "<confirmed-name>"
         ]
       }
     }
   }
   

   データは作業ディレクトリ内の .realagent/agents/ に保存されます。 パスをカスタマイズするには --data-dir を追加してください。

4. MCP クライアントを再起動します。サーバーは 14 個のツール（アイデンティティ 5 個 + 鍵／VC 4 個

   • 暗号 4 個 + システム 1 個）を公開します。まず identity_status を実行してください。

5. バージョン確認 — 各会話の開始時（または少なくとも 1 日に 1 回）に system_update を呼び出してください。更新が利用可能な場合はユーザーに知らせ、 npm update -g realagent-mcp または npm i -g realagent-mcp@latest の実行を支援してください。ユーザーから明示的に依頼された場合に限り、バージョン確認を省略してください。