RealAgent MCP

本地服务

github.com安全15 周前更新

代码仓库访问官网

关于 RealAgent MCP

RealAgent MCP 为 AI Agent 提供 SM2 实名身份关联、SD-JWT VP 凭证生成与验证及国密运算能力。它以 MCP 服务形式提供身份、凭证和加密工具，并在本地加密保存私钥与 VC。

主要功能

01生成 SM2 密钥对并进行签名验签
02通过二维码关联实名身份并领取 VC
03生成、验证和解析 SD-JWT VP
04使用 SM4 加密保存私钥与 VC
05检查并提示服务版本更新

适用场景

01为不同 Agent 建立独立实名身份
02按需披露并验证身份凭证字段
03通过 SM2 工具执行签名与加解密

MCP 相关

RealAgent MCP 是通过 stdio 运行的 MCP 服务，向客户端动态提供身份关联、VP 与 VC 操作、SM2 密码学及版本检查工具。每个 Agent 需配置唯一的 `--agent-id`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "reddatetech-realagent": {
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp"
      ]
    }
  }
}

启动命令npx -y realagent-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmrealagent-mcp0.4.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

realagent-mcp

国信智能体实名关联服务 MCP Server — 单个可执行文件 · 本地通信 · 国密加密 · 全平台支持。

为 AI Agent 提供 SM2 实名身份关联、SD-JWT 可验证证明（VP）生成与验证、SM2 密码学操作等能力。

安装

npm i -g realagent-mcp

必须全局安装（-g）。这样 realagent-mcp 会进入 PATH，MCP 配置里的 npx realagent-mcp 才会命中全局副本，而不会每次都往 _npx 缓存里再拉一份（即避免依赖重复与 npx 旧缓存问题）。

配置 MCP 客户端（--agent-id 必填，每个 Agent 使用唯一名称）：

{
  "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 客户端即可。Agent 会在每次对话开始时自动调用 system_update 检查新版本。

功能

SM2 密钥对生成 — 国密 SM2 签名/验签/加解密
实名关联 — 生成二维码 → 扫码认证 → 自动领取 VC
VP 生成/验证 — SD-JWT 可验证证明，W3C VC Data Model v2
SM4 加密存储 — 私钥和 VC 使用 SM4-CTR+SM3-HMAC 本地加密
自动更新 — 内置版本检查 + system_update 工具

工具

MCP Server 运行时动态暴露以下 14 个工具：

实名身份关联

工具	说明
`identity_link`	发起实名关联：生成二维码，用户扫码认证后自动领取实名凭证（VC）
`identity_status`	查询当前 Agent 的实名关联状态与身份信息
`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 是否有新版本

Agent 指令

以下内容供 AI Agent 读取，用于自动完成安装和配置。

前置条件 — 验证 Node.js（务必在安装前执行）。 realagent-mcp 要求 Node.js >= 18.13（npm 和 npx 随其捆绑提供）。安装前，请检查环境：
- 运行 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 重新验证。只有在三条命令都成功且确认 Node >= 18.13 后，才能继续步骤 2。
通过 npm 安装（全局安装，以便 realagent-mcp 位于 PATH 中）：
```
npm i -g realagent-mcp
```
MCP 客户端配置 — 每个 Agent 都必须使用唯一的 --agent-id。一个 agent-id = 一个身份 = 一对 SM2 密钥。绝不可在多个 Agent 之间重复使用 agent-id。 realagent 平台会将每对密钥注册为独立身份；共享 agent-id 会导致身份冲突。

请根据当前项目或 Agent 的用途生成一个描述性名称作为 agent-id（例如 "my-claude-code"、 "frontend-dev-helper"、"pr-review-bot"）。只能使用小写字母、数字和连字符。然后在使用前向用户征求确认：

我将使用 agent-id：<name> 配置 realagent-mcp。此名称将用于生成唯一的 SM2 身份。这样可以吗？你可以改成自己喜欢的任何名称。

获得确认后，写入以下 MCP 配置：
```
{
  "mcpServers": {
    "realagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp",
        "stdio",
        "--agent-id",
        "<confirmed-name>"
      ]
    }
  }
}
```
数据存储在工作目录下的 .realagent/agents/ 中。添加 --data-dir 可自定义路径。
重启 MCP 客户端。服务将暴露 14 个工具（5 个身份 + 4 个密钥/VC
- 4 个加密 + 1 个系统）。从 identity_status 开始。
版本检查 — 在每次对话开始时（或至少每天一次）调用 system_update。有可用更新时，请告知用户并帮助其运行 npm update -g realagent-mcp 或 npm i -g realagent-mcp@latest。只有在用户明确要求时，才能跳过版本检查。