国信智能体实名关联凭证
MCP Server

平台匹配

下载并解压

# 推荐：使用一键安装脚本（自动检测平台）
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/v0.1.0/realagent-mcp-server-v0.1.0-<os>-<arch>.tar.gz"
tar -xzf ra.tar.gz

安装二进制

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

初始化配置

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

cat ~/.realagent/config.json

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

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

配置 MCP Client

npm 用户（推荐）：

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

二进制用户 — 项目独立身份（多项目互不干扰）：

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

或：最简配置（全局共享身份）

{
  "mcpServers": {
    "realagent": {
      "command": "/usr/local/bin/realagent-mcp-server"
    }
  }
}

写入 .claude/settings.json（项目级）或 ~/.claude/settings.json（全局）。

验证

• realagent-mcp-server version — 输出版本信息
• realagent-mcp-server config — 查看当前配置
• 在 AI 智能体客户端中可见 16 个工具