Keep Protocol

🦀 Agent 间安全通信的极速协议

基于 TCP + Protobuf 的轻量级 Agent 间安全通信协议,支持 ed25519 签名认证、MCP 工具快速调用(60ms 延迟)与 Agent 发现路由,适合构建去中心化 AI 代理网络。

收藏
8.4k
安装
2.6k
版本
1.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

keep-protocol 是专为 AI Agent 间通信设计的轻量级协议栈,采用 TCP + Protobuf + ed25519 数字签名 三层架构。核心工作模式为:Agent 向 TCP 端点(默认 localhost:9009)发送签名 Packet,服务端验证签名后执行路由、记录与回复;无效签名则静默丢弃。

双路径接入设计

  • MCP 快速通道(推荐):通过 keep_sendkeep_discoverkeep_listen 等 MCP 工具直接调用,延迟低至 60ms,较传统代码生成方式提升 100 倍以上
  • SDK 代码生成(备用):Python SDK 提供 KeepClient 类,支持发现、路由、监听、内存交易(Memory Barter)等完整功能

关键特性

  • 身份认证:ed25519 曲线签名确保每包完整性与不可抵赖
  • Agent 发现:动态查询在线 Agent 列表与服务端状态
  • 点对点路由:直接寻址 bot:alice 等逻辑身份
  • 内存交易:通过 scar 字段共享结构化知识(如 gitmem commit)
  • 经济反垃圾:内置 fee + ttl 字段支持轻量级速率限制

显著优点

1. 极致延迟优化:MCP 工具路径将 Agent 协作延迟从百秒级压缩至亚秒级,满足实时协调场景
2. 安全默认:强制 ed25519 签名,无签名即丢弃,杜绝中间人攻击与伪造身份

3. 零配置发现:自动 Agent 注册与发现,无需中心目录服务

4. 内存原生scar 字段设计支持知识交换,契合 LLM Agent 的长期记忆需求

5. 轻量部署:单容器 Docker 运行,Python SDK 无重依赖

潜在缺点与局限

  • TCP 单点依赖:默认中心化服务端架构,未原生支持 P2P 去中心化
  • MCP 环境绑定:最优体验需 MCP Server 预配置,裸环境需回退 SDK
  • 协议年轻:v0.5.0 阶段,生产级长期稳定性待验证
  • 生态局限:目前主要 Python 生态,多语言 SDK 待完善
  • 无内置加密:签名保障完整性,但 Payload 明文传输(建议配合 TLS 或 VPN)

适合人群

  • 构建 多 Agent 协作系统 的开发者(如 AutoGPT 替代架构)
  • 需要 亚秒级 Agent 间通信 的实时决策场景
  • 关注 轻量级自托管 的隐私敏感团队
  • 探索 Agent 经济/知识交换 机制的协议研究者

常规风险

| 风险类型 | 说明 |
|---------|------|
| 服务端单点故障 | TCP 服务端宕机导致全网通信中断,建议集群部署 |
| 密钥管理 | ed25519 私钥泄露导致身份冒充,需安全存储 |
| 流量分析 | 明文 Protobuf 可能被被动监听,敏感场景需 TLS 封装 |
| MCP 供应链 | 依赖 `keep-mcp` 二进制,需验证发布签名 |
| 资源耗尽 | 无内置全局速率限制,恶意 Agent 可耗尽连接池 |

综合评估:keep-protocol 是 Agent 通信领域的创新轻量方案,MCP 集成使其在易用性与性能间取得罕见平衡,适合作为 Agent 网络的"微服务总线",但生产部署需补充加密层与高可用架构。

Keep Protocol 内容

docs文件夹
examples文件夹
keep-protocol-clawhub文件夹
python文件夹
keep文件夹
mcp文件夹
tests文件夹
手动下载zip · 55.0 kB
clawhub-publishing.mdtext/markdown
请选择文件