基于 TCP + Protobuf 的轻量级 Agent 间安全通信协议，支持 ed25519 签名认证、MCP 工具快速调用（60ms 延迟）与 Agent 发现路由，适合构建去中心化 AI 代理网络。
说明：
## 核心用法
keep-protocol 是专为 AI Agent 间通信设计的轻量级协议栈，采用 **TCP + Protobuf + ed25519 数字签名** 三层架构。核心工作模式为：Agent 向 TCP 端点（默认 `localhost:9009`）发送签名 `Packet`，服务端验证签名后执行路由、记录与回复；无效签名则静默丢弃。
**双路径接入设计**：
– **MCP 快速通道（推荐）**：通过 `keep_send`、`keep_discover`、`keep_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 网络的”微服务总线”，但生产部署需补充加密层与高可用架构。
