SoloCore Agent Gateway

SoloCore Agent Gateway 是一个 Apache-2.0 开源的 Agent 互联入口。它通过设备主动出站连接，让无需公网入站端口的本地 Agent 安全接入托管 Hub，并向 MCP 与 A2A 客户端暴露受控能力。

当前状态：v0.2.0 的无 API 拉取式 Connector 已实现，正在完成 fresh verification 与公网部署。远端健康、DNS/TLS 和真实 Aily 往返只有在直接验证后才视为完成。

快速开始

已发布 npm 包时可固定版本安装；未发布前从公开仓库固定 tag v0.2.0 构建：

git clone --branch v0.2.0 --depth 1 https://github.com/lihongqing2001-gif/SoloCoreAgentGateway.git solocore-agent-gateway
cd solocore-agent-gateway && npm ci && npm run build

Aily 无 App ID、OpenAPI Scope 或管理员权限时，设备本地生成 Ed25519 密钥并请求人工审批：

node dist/cli.js connect request --gateway https://agents.solocore.cn \
  --agent aily-agent --credential-backend file-0600

审批后使用 connect await 完成登记，再通过 chat send --stdin --wait 与 inbox pull 收发。可直接复制给 Aily 的完整一条消息见 Aily 接入指令。托管 Hub 可用 Docker Compose 全新安装；已有 Nginx 占用 80/443 的主机使用 回环部署配置。

协议入口

• 控制面：https://agents.solocore.cn
• MCP Streamable HTTP：https://mcp.solocore.cn/mcp
• A2A：https://a2a.solocore.cn/a2a
• 设备主动出站 Relay：wss://relay.solocore.cn/v1/device

上述公网地址只有在 DNS 与 TLS 验证完成后才视为可用。Aily 示例见 config/aily.mcp.example.json，Token 必须进入 Aily Secret，不得写入配置文件。

首版边界

• 允许：Agent 发现、能力查询、受控任务传递、显式发布目录中的只读资源、健康检查和诊断。
• 禁止：任意 Shell、任意文件写入、凭据访问、生产操作和未注册命令。
• 默认：设备连接 relay.solocore.cn:443，不开放路由器或防火墙入站端口。
• 可选：Aily 直连托管 MCP；高级用户可使用经检查的自托管 direct 配置。

设计、安全审查、验证状态和外部阻塞见 docs/INDEX.md。

安全提示

Enrollment Key 只能通过隐藏交互输入或 Docker Secret 提供，不得出现在命令行、聊天、Git、日志或明文配置中。仓库只包含示例与凭据元数据。

License

Apache-2.0，见 LICENSE。