代理注册 是一个为 人工智能代理和MCP的注册、发现和管理 服务器.
它提供了一个 代理人和工具的单一真相来源，允许 AI系统用于动态发现代理、检索其定义， 并使用所需的初始化其运行时环境 法学硕士, 工具和MCP服务器.
注册表同时支持这两种 通过API实现机器对机器集成 和 通过UI进行人性化管理.
______________________________________________________________________
🚀 核心能力
代理注册表支持以下核心功能：
- 代理注册和生命周期管理
- MCP服务器注册和管理
- 动态发现代理
- 检索完整的代理定义（快照）
- 代理和MCP服务器的运行状况监控
- 工具、MCP服务器和AI模型与代理的关联
- 代理和MCP服务器定义的导出和导入
______________________________________________________________________
🧠 架构概述
代理注册处充当 中心枢纽 哪里：
- AI代理可以 注册自己
- 其他代理人可以 发现可用代理
- 代理商可以 检索其完整的运行时定义
- 系统可以 检查可用的MCP工具
这使得 动态人工智能生态系统 其中代理可以与 没有硬编码依赖关系的工具和服务。
______________________________________________________________________
🔹 MCP服务器模块
MCP服务器模块允许管理和发现 模型上下文 协议（MCP）服务器 以及他们的工具。
代理整合
- 通过REST API注册MCP服务器
- 通过REST API注销MCP服务器
- 通过REST API获取MCP服务器快照
- MCP服务器的健康检查监控
UI操作
- 通过UI创建和编辑MCP服务器
- 导入MCP服务器定义
- 将MCP服务器定义导出为JSON
- 删除MCP服务器
- 检查MCP工具
- 直接从UI调用MCP工具
______________________________________________________________________
🔹 AI代理模块
AI Agent模块管理生命周期和发现 人工智能 代理.
AI应用集成
- 通过REST API注册AI代理
- 通过REST API注销AI代理
- 使用高级过滤/搜索/排序发现代理
- 通过REST API获取完整代理快照
- 代理的健康检查监控
UI操作
- 创建和编辑AI代理
- 将AI模型与代理相关联
- 将MCP服务器和工具与代理相关联
- 配置代理发现端点
- 进出口代理定义
- 删除代理定义
______________________________________________________________________
📡 REST API端点
AI代理API
注册代理人
发布 /v1/api/registry/agents/register
注销代理
发布 /v1/api/registry/agents/unregister/{agentName}/{agentVersion}
发现代理
发布 /v1/api/registry/agents/discover
支持：
- 排序
- 搜索（完全/部分匹配）
- 筛选（名称、版本、标签、状态、已启用）
获取代理快照
获取 /v1/api/registry/agents/{agentId}/definition
返回 完整运行时定义 代理人包括：
- MCP服务器
- 工具
- LLM配置
- 发现端点
______________________________________________________________________
MCP服务器API
注册MCP服务器
发布 /v1/api/registry/mcp-servers/register
注销MCP服务器
发布 /v1/api/registry/mcp-servers/unregister/{serverName}/{serverVersion}
获取MCP服务器快照
获取 /v1/api/registry/mcp-servers/{serverId}/definition
______________________________________________________________________
📚 API文档
所有OpenAPI规范都位于以下位置：
/swagger
文件描述
______________________________________________________________________
agent-register.yaml代理注册API agent-discover.yaml代理发现API agent-snapshot.yaml代理快照API mcp-server-register.yaml mcp服务器注册API mcp-server-management.yaml mcp服务器管理API
这些文件可以导入到：
- Swagger 用户界面
- 邮递员
- 失眠
- 刹车灯
- Redoc
______________________________________________________________________
🌐 应用访问
前端用户界面
可用网址：
http://localhost:3000
默认凭据：
用户名： admin\ 密码： admin
______________________________________________________________________
后端API
可用网址：
http://localhost:8080
提供以下API：
- 代理商注册
- 代理发现
- 代理快照检索
- MCP服务器注册
- MCP服务器快照检索
- 健康检查
______________________________________________________________________
🐳 使用Docker运行
1.️⃣ 克隆存储库
git clone https://github.com/agentic-runtime/agentic-registry.git
cd agentic-registry2.️⃣ 从Docker Compose开始
docker-compose up --build启动后：
前端用户界面→ http://localhost:3000\ 后端API→ http://localhost:8080
______________________________________________________________________
🤝 贡献
- 分叉存储库\\
- 创建要素分支\\
- 提交您的更改\\
- 提交拉取请求
______________________________________________________________________
📄 许可证
MIT许可证——有关详细信息，请参阅许可证文件。
______________________________________________________________________
👤 维护者
吉列尔莫·沃巴\ 首席解决方案架构师
github：\ https://github.com/agentic-runtime
______________________________________________________________________
______________________________________________________________________
📦 更新日志
版本1.2.5
✨ 新功能
- 代理发现API
- 引入了一个新的发现端点： - POST /v1/api/registry/agents/discover - 支持： - 排序（ASC/DESC） - 搜索（完全匹配/部分匹配） - 按名称、版本、标签、状态和启用标志等字段进行筛选。
- 代理快照检索
- 添加了端点以检索代理的完整运行时定义： - GET /v1/api/registry/agents/{agentId}/definition - 退货： - 与代理关联的MCP服务器 - 通过MCP服务器公开的工具 - LLM配置 - 发现端点配置
- 代理注销API
- 代理现在可以从注册表中注销自己： - POST /v1/api/registry/agents/unregister/{agentName}/{agentVersion}
- MCP服务器注销API
- MCP服务器现在可以通过API移除： - POST /v1/api/registry/mcp-servers/unregister/{serverName}/{serverVersion}
______________________________________________________________________
⚙️ 改进
- 启用标志强制
- 发现和内部查询现在按以下方式过滤代理： - status = ACTIVE - is_enabled = true
- DTO标准化
- 改进的结构： - AgentSnapshotDTO - MCP服务器快照对象 - 以下内容的标准化元数据表示： - LLM - MCP工具 - 发现配置
- Swagger/OpenAPI文档
- 为以下内容添加了新的Swagger定义： - 代理商注册 - 代理发现 - 代理快照检索 - MCP服务器注册 - MCP服务器管理
______________________________________________________________________
🛠 内部变更
- 改进了用于发现的服务层过滤逻辑。
- 重构快照DTO映射。
- 跨端点的标准化API错误响应。
- 改进了Swagger结构，便于与外部客户端集成。
______________________________________________________________________
📚 文档更新
- 更新
README.md与：
- 新的API端点 - 更新的架构描述 - Swagger文件引用 - Docker运行说明 - 变更日志部分
______________________________________________________________________
🚀 感谢您使用 代理注册