Keep Protocol

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

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

收藏
8.4k
安装
2.6k
版本
1.1.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

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 是一个专为AI Agent间通信设计的轻量级协议,采用 ed25519签名 + TCP + Protobuf 技术栈,实现安全、高效的点对点消息交换。

两种使用模式

首选:MCP工具(推荐)

  • 延迟低至60ms,比代码生成方式快100倍
  • 工具包括:keep_sendkeep_discoverkeep_listenkeep_ensure_server
  • 安装:pip install keep-protocol[mcp]

备选:Python SDK

  • 代码生成方式,延迟约100秒
  • 支持完整的发现、路由、内存共享功能
  • 典型用法:KeepClient(src="bot:planner").send(body="...", dst="bot:alice")

关键特性

  • Agent发现:动态查询在线Agent列表
  • Agent路由:直接发送消息到指定Agent(如 bot:weather
  • Memory Barter:通过scar字段共享知识
  • 经济机制:内置fee和ttl防垃圾消息

---

显著优点

1. 极低延迟:MCP工具路径实现sub-60ms响应,适合实时Agent协作
2. 轻量安全:ed25519签名保证认证和完整性,无需TLS即可安全通信

3. 生态兼容:原生支持MCP(Model Context Protocol),与Claude等模型无缝集成

4. 灵活发现:支持服务器信息查询和Agent列表获取

5. 知识共享:独特的scar字段设计,实现Agent间内存/知识交换

---

潜在局限

1. 传输层未加密:依赖签名而非TLS,存在流量分析风险
2. 本地网络限制:默认绑定localhost:9009,跨网络需额外配置

3. 子进程依赖ensure_server()自动启动Docker/Go服务器,需系统权限

4. 缓存权限:~/.keep/endpoints.json未强制0600权限

5. MCP新生态:MCP协议较新,长期稳定性待观察

---

适合人群

  • 构建多Agent系统的开发者
  • 需要sub-100ms延迟的实时Agent协作场景
  • 使用Claude/MCP生态的AI应用开发者
  • 追求轻量级替代方案(对比gRPC/HTTP2)的技术团队

---

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 子进程创建 | 中等 | Docker/Go服务器自动启动需系统权限 |
| 传输层明文 | 低 | 签名保证完整性但无加密,建议内网使用 |
| 缓存文件权限 | 低 | endpoints.json可能暴露网络拓扑 |
| 依赖供应链 | 低 | cryptography/protobuf/MCP需定期更新 |

安全建议:生产环境建议显式禁用auto-start、配置防火墙限制9009端口、定期审查依赖更新。

Keep Protocol 内容

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