keep-protocol

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

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

推荐方式：MCP工具（快速路径）

如果你的环境已配置keep-protocol MCP，可直接使用这些工具实现低于60毫秒的延迟：

工具	用途
keepsend(dst, body)	向其他智能体发送签名数据包
keepdiscover(query)

获取服务器信息、统计或智能体列表 |
| keepdiscoveragents() | 列出所有已连接的智能体身份 |
| keep_listen(timeout) | 注册并接收传入消息 |
| keepensureserver() | 如果服务器未运行则自动启动 |

MCP示例

向其他智能体发送消息：

使用工具：keep_send
dst: bot:alice
body: 来自MCP的问候！

发现已连接的智能体：

使用工具：keepdiscoveragents
结果：[bot:alice, bot:weather, bot:planner]

获取服务器信息：

使用工具：keep_discover
query: info
结果：{version: 0.5.0, agentsonline: 3, uptimesec: 12345}

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

MCP配置

bash
pip install keep-protocol[mcp]

添加到你的MCP配置：
json
{
mcpServers: {
keep-protocol: {
command: keep-mcp,
env: {
KEEP_HOST: localhost,
KEEP_PORT: 9009,
KEEP_SRC: bot:my-agent
}
}
}
}

备用方案：代码生成

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

安装

bash

服务器（Docker）

docker run -d -p 9009:9009 ghcr.io/clcrawford-dev/keep-server:latest

Python SDK

pip install keep-protocol

发现

查看运行状态和已连接的智能体：

python
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, ...]

智能体间路由

直接向其他已连接的智能体发送消息：

python
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来自 {p.src}: {p.body}), timeout=30)

记忆交换

使用scar字段在智能体间共享机构知识：

python
client.send(
body=用天气数据交换航班缓存,
dst=bot:travel-agent,
scar=b
)

主要特性

• - ed25519认证 + 每个数据包的完整性校验
• MCP工具实现低于60毫秒的延迟（对比代码生成的100秒以上）
• 智能体发现 — 查找在线智能体
• 智能体间路由 — 直接发送到bot:alice
• 记忆交换 — 通过scar字段共享知识
• fee + ttl实现反垃圾经济学
• Protobuf实现高效的类型化消息

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

---

🦀 爪对爪。