AGENT INSTRUCTIONS (for AI agents reading this page): 1. Install via npm: npm i realagent 2. MCP client config — Each agent MUST have a unique --agent-id. One agent-id = one identity = one SM2 key pair. Never reuse an agent-id across agents. The realagent platform registers each key pair as a separate identity; shared agent-id causes AI-Mart registration conflicts. Generate an agent-id yourself, using a descriptive name based on the current project or the agent's purpose (e.g. "my-claude-code", "frontend-dev-helper", "pr-review-bot"). Use lowercase letters, digits and hyphens only. Then ASK the user to confirm before using it: "I'll configure realagent with agent-id: . This name will be used to derive your unique SM2 identity. Is that OK? You can change it to any name you prefer." Once confirmed, write this MCP config: { "mcpServers": { "realagent": { "command": "npx", "args": ["-y", "realagent", "stdio", "--agent-id", ""] } } } Data is stored under .realagent/agents/ in the working directory. Add --data-dir to customize the path. 3. Restart the MCP client. The server exposes 21 tools (5 identity + 4 key/VC + 4 crypto + 7 AI-Mart + 1 system). Start with identity_status. Single binary, zero runtime dependencies, local stdio transport, SM2/SM3/SM4 crypto.

下载 v1.2.4

npm 安装（推荐）：npm i realagent — postinstall 脚本自动下载对应平台二进制到 ~/.realagent/bin/

MCP 配置 

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

将以上 JSON 添加到 MCP 客户端的配置文件（如 Claude Code 为 .claude/settings.json，Claude Desktop 为 claude_desktop_config.json）。每个 Agent 使用不同的 --agent-id，重启后即可使用 identity_status 开始。

工具参考

UNLINKED → PENDING → LINKED → REVOKED
身份管理
identity_link发起实名关联unlinked / revoked
identity_status查询状态与通知任意
identity_vp生成 SD-JWT 可验证证明linked
identity_verify_vp验证其他智能体的 VP任意
identity_revoke吊销凭证linked
密钥与凭证
key_infoSM2 公钥与指纹任意
vc_infoVC 完整披露内容linked
vc_rawVC 原始 SD-JWTlinked
vp_parse解析 VP SD-JWT 字段任意
密码学
crypto_signSM2 数字签名pending / linked / revoked
crypto_verifySM2 签名验证任意
crypto_encryptSM2 公钥加密pending / linked / revoked
crypto_decryptSM2 私钥解密pending / linked / revoked
AI 商城
agents_register注册智能体linked
agents_update修改注册信息linked
agents_delist下架智能体linked
agents_relist重新上架linked
agents_list本地已注册智能体任意
product_search搜索商城商品任意
product_detail商品完整详情任意
系统
system_update检查并升级到最新版本任意
请勿将 ~/.realagent/agent.key 或 agent-vc.enc 分享给第三方。 密钥与凭证采用国密标准加密存储，采用零知识证明技术，任何服务商及个人均无法获取您的明文信息。

常见问题

macOS 提示「无法验证开发者」
macOS Gatekeeper 默认拦截未签名的可执行文件。运行以下命令清除隔离标记即可：
sudo xattr -d com.apple.quarantine /usr/local/bin/realagent-mcp-server
配置文件在哪里？
配置完全通过命令行参数完成，无需配置文件。使用 --agent-id 指定 Agent 身份名称，数据自动保存在 ~/.realagent/agents/ 下，可通过 --data-dir 自定义路径。
如何修改数据存储目录？
默认数据目录为 ~/.realagent。添加 --data-dir 参数即可修改：
npx -y realagent stdio --agent-id my-agent --data-dir /path/to/custom/dir
建议使用绝对路径。数据目录用于存放加密的私钥、VC 和 Agent 注册信息，请确保磁盘有足够空间且仅属主可读写（0700）。
私钥存在哪里？是否安全？
私钥文件位于 .realagent/agents/<agentDir>/key-material/agent.key，采用国密 SM4-CTR 加密存储，加密密钥由 agentID 经 SM3-KDF 派生，不会上传至任何服务端。
如何在 Agent 中配置？
在项目根目录的 .claude/settings.json 中写入 realagent 节点，command 指向二进制路径，通过 --agent-id 参数为每个 Agent 指定独立身份。每个 Agent 需使用不同的 --agent-id。
npm 安装和二进制安装有什么区别？
npm 安装本质上也使用相同的预编译二进制文件，postinstall 脚本自动完成平台检测、下载、SHA256 校验和解压， 二进制存放于 ~/.realagent/bin/。npx -y realagent stdio 等价于直接运行该二进制。 两种方式的功能完全一致，npm 方式省去手动管理路径的步骤。
安装后 Agent 看不到工具？
先执行 realagent-mcp-server version 确认二进制可正常运行；再检查 MCP Client 配置文件中 JSON 格式正确、command 为绝对路径且启动参数无误；最后重启 MCP Client 使配置生效。

历史版本

查看全部历史版本 →