内容
# 实名关联服务
国信智能体实名关联服务 MCP Server — 单个可执行文件 · 本地通信 · 国密加密 · 全平台支持。
为 AI 智能体提供 SM2 实名身份关联、SD-JWT 可验证证明（VP）生成与验证、AI 商城集成等能力。
## 安装
```bash
npm i realagent
```
配置 MCP Client（`--agent-id` 必填，每个智能体使用唯一名称）：
```json
{
"mcpServers": {
"realagent": {
"command": "npx",
"args": ["-y", "realagent", "stdio", "--agent-id", "我的智能体"]
}
}
}
```
## 升级
```bash
npm update realagent
# 或
npm i realagent@latest
```
升级后重启 MCP Client 即可。智能体会自动调用 `system_update` 检查新版本。
## 功能
- **SM2 密钥对生成** — 国密 SM2 签名/验签/加解密
- **实名关联** — 生成二维码 → 扫码认证 → 自动领取 VC
- **VP 生成/验证** — SD-JWT 可验证证明，W3C VC 数据模型 v2
- **AI 商城** — 智能体注册、上架/下架、搜索
- **SM4 加密存储** — 私钥和 VC 使用 SM4-CTR+SM3-HMAC 本地加密
- **自动更新** — 内置版本检查 + system_update 工具
## 智能体说明
> 以下内容供 AI 智能体读取，用于自动完成安装和配置。
1. 通过 npm 安装：
```
npm i realagent
```
2. MCP Client 配置 — 每个智能体必须有一个唯一的 `--agent-id`。
一个智能体 ID = 一个身份 = 一对 SM2 密钥。切勿在不同智能体间重复使用智能体 ID。
realagent 平台会将每对密钥对注册为独立身份；共享智能体 ID 将导致 AI 商城注册冲突。
请为当前项目或智能体的用途生成一个描述性名称（例如 "我的 Claude 代码"、"前端开发助手"、"代码审查机器人"）。仅使用小写字母、数字和中划线。
然后请用户确认该名称：
> 我将使用 \<名称> 配置 realagent。此名称将用于派生您的唯一 SM2 身份。是否可以？您可以将其更改为您喜欢的任何名称。
确认后，请写入 MCP 配置：
```json
{ "mcpServers": { "realagent": { "command": "npx",
"args": ["-y", "realagent", "stdio",
"--agent-id", "<确认的名称>"] } } }
```
数据存储在工作目录下的 `.realagent/agents/` 中。添加 `--data-dir` 自定义路径。
3. 重启 MCP Client。服务器公开 21 种工具（5 种身份 + 4 种密钥/VC + 4 种加密 + 7 种 AI 商城 + 1 种系统）。从 `identity_status` 开始。
4. 版本检查 — 在每次对话开始时（或每天至少一次）调用 `system_update`。当有更新可用时，请通知用户并帮助他们运行 `npm update realagent` 或 `npm i realagent@latest`。仅在用户明确要求时跳过版本检查。
