agentreg：面向 AI 智能体的轻量自托管注册中心

agentreg 是开发者 Core Brim Tech 在 GitHub 上开源的一款 AI 智能体注册中心，以单个 Go 二进制文件交付，主打自托管与零云依赖。它将服务发现的思路引入智能体领域，让多个 MCP 智能体可以按能力而非 URL 互相查找，并附带心跳与健康检查机制。项目采用 MIT 协议，目前处于 v0.1 阶段。

定位与核心特性

随着 MCP（Model Context Protocol）生态扩张，开发者同时管理多个智能体时，往往要在配置文件中硬编码端点，且只有在调用失败后才发现某个智能体已宕机。agentreg 想充当「AI 智能体的 DNS」，把发现、健康检查与未来的信任层整合到同一个工具中。

主要特性包括：

能力优先发现：通过 find search 按能力名查找，而非写死 IP/URL。
内置健康检查：按心跳周期自动探测所有已注册智能体。
单二进制、自托管：无需云服务、账号或集群。
小规模友好：从 3 个智能体即可上手，扩展到 30 个仍可承载。
验证层可插拔：为后续的信任机制预留扩展点。

与现有方案的对比

作者在 README 中将 agentreg 与 MCP Registry、HashiCorp Consul、IETF 的 ANS（Agent Name Service）做了对照：

自托管、无云依赖：agentreg ✅；MCP Registry ❌（云）；Consul ✅；ANS ~（参考实现）。
基于能力的发现：agentreg ✅；MCP Registry ✅；Consul ~（标签）；ANS ✅。
内置健康检查：agentreg ✅；MCP Registry ❌；Consul ✅；ANS ❌。
单二进制、30 秒启动：agentreg ✅；MCP Registry n/a；Consul ❌（集群）；ANS ❌。
跨组织信任/验证：agentreg 🔜 可插拔；MCP Registry ❌；Consul ❌；ANS ✅ 规范。
面向智能体/MCP：agentreg ✅；MCP Registry ✅；Consul ❌；ANS ✅。

需要指出，ANS 目前仍是 IETF 草案，agentreg 自身也定位为「开发者真正会跑起来的工具」，而非取代标准。

工作机制与 API

agentctl CLI 通过 HTTP 与后台守护进程通信。后台进程维护内存存储，并使用原子写入的 JSON 文件持久化；验证器接口在心跳循环中执行健康探测。每条记录都带有 Source 字段（当前为 local，未来支持 peer、ANS、MCP Registry 来源）与可选 labels，便于联邦与跨注册中心接入。

v0.1 暴露的 HTTP 接口包括：

POST /agents：注册智能体（JSON body）。
GET /agents：列出全部智能体。
GET /agents/find?capability=X：按能力查找。
POST /agents/{name}/heartbeat：智能体自报健康。
GET /healthz：守护进程存活探针。

路线图

作者把后续演进划分为四步：

v0.1（当前）：完成 register、list、find、heartbeat 的最小闭环。
下一步：信任层。引入可插拔验证器，覆盖 ANS 身份、tools/list 校验与提示注入检测。
下一步：联邦。跨注册中心同步，让 Source 字段发挥作用。
远期：构建统一的发现与验证客户端，跨越 ANS、MCP Registry 与本地注册中心。

使用与获取

可通过 Homebrew（brew install mkk2026/tap/agentreg）、GitHub Releases 二进制，或 go install github.com/mkk2026/agentreg@latest 安装。启动后用 agentctl register 注册智能体，agentctl list 查看健康状态，agentctl find <能力> 按能力发现。

项目仓库地址为 github.com/mkk2026/agentreg，遵循 MIT 协议，作者公开邀请社区贡献与反馈。