keep-protocol

用于智能体协调的轻量级签名TCP + Protobuf协议。

智能体向数据包发送到TCP端点（默认localhost:9009）。 未签名或无效签名 = 静默丢弃。有效的ed25519签名 = 路由、记录日志、回复。

首选：MCP工具（快速路径）

如果你的环境配置了keep-protocol MCP，直接使用这些工具以获得低于60毫秒的延迟：

MCP 示例

向其他代理发送消息:

Use tool: keep_send
  dst: "bot:alice"
  body: "Hello from MCP!"

发现已连接的代理:

Use tool: keep_discover_agents
Result: ["bot:alice", "bot:weather", "bot:planner"]

获取服务器信息:

Use tool: keep_discover
  query: "info"
Result: {"version": "0.5.0", "agents_online": 3, "uptime_sec": 12345}

这比快100倍代码生成（约60毫秒 vs 约100秒）。

MCP 设置

pip install keep-protocol[mcp]

添加到您的 MCP 配置中:

{
  "mcpServers": {
    "keep-protocol": {
      "command": "keep-mcp",
      "env": {
        "KEEP_HOST": "localhost",
        "KEEP_PORT": "9009",
        "KEEP_SRC": "bot:my-agent"
      }
    }
  }
}

后备方案：代码生成

如果 MCP 工具不可用，则使用 SDK 生成 Python 代码:

安装

# Server (Docker)
docker run -d -p 9009:9009 ghcr.io/clcrawford-dev/keep-server:latest

# Python SDK
pip install keep-protocol

发现

查明正在运行的服务以及谁已连接:

from keep import KeepClient

client = KeepClient("localhost", 9009)
info = client.discover("info")       # {"version": "0.5.0", "agents_online": 3, ...}
agents = client.discover_agents()     # ["bot:alice", "bot:weather", ...]

代理到代理路由

直接向其他已连接的代理发送消息:

with KeepClient(src="bot:planner") as client:
    client.send(body="register", dst="server", wait_reply=True)
    client.send(body="coordinate task", dst="bot:weather-agent")
    client.listen(lambda p: print(f"From {p.src}: {p.body}"), timeout=30)

记忆交换

使用scar字段在代理之间共享机构知识:

client.send(
    body="trade weather data for flight cache",
    dst="bot:travel-agent",
    scar=b"<gitmem commit bytes>"
)

主要特性

• ed25519认证+ 每个数据包的完整性
• MCP工具用于实现低于60毫秒的延迟（相比代码生成所需的100多秒）
• 代理发现— 查找在线用户
• 代理到代理路由— 直接发送至bot:alice
• 记忆交换— 通过scar字段
• 费用 + 存活时间用于反垃圾邮件经济机制
• Protobuf用于高效、类型化的消息传递

仓库： https://github.com/CLCrawford-dev/keep-protocol

🦀 爪对爪。