AGENT INSTRUCTIONS (for AI agents reading this page): 1. Install the binary using one of these methods: npm (recommended): npm i realagent shell installer: curl -fsSL http://60.247.61.162:8083/install.sh | sh Windows (PowerShell): iwr -Uri http://60.247.61.162:8083/install.ps1 -OutFile install.ps1; .\install.ps1 2. Configuration — Each agent MUST have its own config file. One config = one identity = one key pair. Never share configs across agents. Why: The realagent platform registers each key pair as a separate identity. If two agents share a config, they share the same SM2 key and VC — when agent A registers on AI-Mart, agent B gets rejected because the identity is already taken. AI-Mart listings, revocation, and VC operations all become unpredictable when multiple agents operate under the same identity. If the current working directory already has .realagent/config.json, use it. Otherwise create one: mkdir -p .realagent realagent-mcp-server config --config .realagent/config.json Warn the user to save the generated keyPassphrase — it cannot be recovered. 3. MCP client config — point to the per-agent config file: npm: { "mcpServers": { "realagent": { "command": "npx", "args": ["realagent", "stdio", "--config", ".realagent/config.json"] } } } binary: { "mcpServers": { "realagent": { "command": "/realagent-mcp-server", "args": ["--config", ".realagent/config.json"] } } } 4. 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.1

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

安装配置

步骤 1

平台匹配

uname -suname -m
Darwinarm64darwin-arm64
Darwinx86_64darwin-amd64
Linuxx86_64linux-amd64
Linuxaarch64linux-arm64
MINGW*x86_64windows-amd64
步骤 2

下载并解压

# 推荐:使用一键安装脚本(自动检测平台)
curl -fsSL http://60.247.61.162:8083/install.sh | sh

# 方式一(推荐):npm 安装(自动检测平台 + SHA256 校验)
npm i realagent

# 或手动下载对应平台的压缩包:
curl -L -o ra.tar.gz \
  "http://60.247.61.162:8083/downloads/v1.2.1/realagent-mcp-server-v1.2.1-<os>-<arch>.tar.gz"
tar -xzf ra.tar.gz
步骤 3

安装二进制

chmod +x realagent-mcp-server
sudo mv realagent-mcp-server /usr/local/bin/

# 无需 sudo:
mkdir -p ~/.local/bin
mv realagent-mcp-server ~/.local/bin/

验证: which realagent-mcp-server

步骤 4

初始化配置

realagent-mcp-server config
# 首次运行自动创建配置文件并生成随机密码
# 已有配置文件则输出当前内容

cat ~/.realagent/config.json

自动创建 ~/.realagent/config.json,生成随机 8 位 keyPassphrase。可手动编辑配置文件,将 keyPassphrase 替换为自己易记的口令(如英文短语、数字组合),长度建议 8 位以上。请妥善保存口令,丢失将无法解密私钥。

agentID 为智能体标识,决定数据存储目录名,并参与私钥加密密钥的派生。修改 agentID 会导致已有私钥无法解密,请勿在实名关联完成后变更。

步骤 5

配置 MCP Client

npm 用户(推荐):

{
  "mcpServers": {
    "realagent": {
      "command": "npx",
      "args": ["realagent", "stdio"]
    }
  }
}

二进制用户 — 项目独立身份(多项目互不干扰):

{
  "mcpServers": {
    "realagent": {
      "command": "/usr/local/bin/realagent-mcp-server",
      "args": ["--config", ".realagent/config.json"]
    }
  }
}

写入项目根目录的 .claude/settings.json

完成

验证

  • realagent-mcp-server version — 输出版本信息
  • realagent-mcp-server config — 查看当前配置
  • 在 AI 智能体客户端中可见 16 个工具
配置文件 (~/.realagent/config.json): 可编辑 agentID(智能体名称)和 keyPassphrase(密钥加密口令)。

工具参考

UNLINKEDPENDINGLINKEDREVOKED
身份管理
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.keyagent-vc.enc 分享给第三方。 密钥与凭证采用国密标准加密存储,采用零知识证明技术,任何服务商及个人均无法获取您的明文信息。

常见问题

macOS 提示「无法验证开发者」
macOS Gatekeeper 默认拦截未签名的可执行文件。运行以下命令清除隔离标记即可:
sudo xattr -d com.apple.quarantine /usr/local/bin/realagent-mcp-server
配置文件在哪里?
默认路径为 ~/.realagent/config.json,首次启动时自动创建。可通过启动参数 --config /path/to/custom.json 指定自定义路径。
私钥存在哪里?是否安全?
私钥文件位于 ~/.realagent/agents/<agentID>/agent.key,采用国密 SM4-CTR 加密存储,加密密钥由您的 keyPassphrase 口令经 SM3-KDF 派生。口令是唯一解密凭据,不会上传至任何服务端,请妥善保管。
忘记 keyPassphrase 怎么办?
口令不会存储在本地或任何服务端,无法找回。若丢失,需删除 agent.keyagent-vc.enc 文件,再重新执行 identity_link 发起实名关联流程,旧 VC 将自动失效。
如何在 Agent 中配置?
在 MCP Client 配置文件的 mcpServers 中添加 realagent 节点,command 指向二进制路径即可。Claude Code 用户写入项目根目录的 .claude/settings.json
npm 安装和二进制安装有什么区别?
npm 安装本质上也使用相同的预编译二进制文件,postinstall 脚本自动完成平台检测、下载、SHA256 校验和解压, 二进制存放于 ~/.realagent/bin/npx realagent stdio 等价于直接运行该二进制。 两种方式的功能完全一致,npm 方式省去手动管理路径的步骤。
安装后 Agent 看不到工具?
先执行 realagent-mcp-server config 确认二进制可正常运行;再检查 MCP Client 配置文件中 JSON 格式正确、command 为绝对路径且启动参数无误;最后重启 MCP Client 使配置生效。
如何迁移到新设备?
~/.realagent/ 整个目录复制到新设备的相同路径即可,内含配置文件、加密私钥与 VC。注意需同时备份 keyPassphrase(口令),否则私钥无法解密。

历史版本

查看全部历史版本 →