🕸️ Agent Mesh Hub

通用多 Agent 协作网络 — 一个适配器,连接所有 Agent

v2.1.0 — Universal Adapter 架构

🎯 核心创新:Universal Agent Adapter

🔌 一个适配器,兼容所有 Agent

1
协议探测

自动检测 Agent 支持的协议(MCP / A2A / 自定义)

2
能力发现

获取 Agent 的工具列表、技能、输入输出模式

3
统一封装

转换为标准 Agent Card,注册到 Mesh Hub

4
智能路由

根据任务类型自动选择最佳 Agent

🔧 MCP Agent

Claude Code
Cursor
Cline

🤝 A2A Agent

Google ADK
LangGraph
AutoGen

🌐 Universal Adapter

协议转换
能力映射
统一接口

📡 Custom Agent

REST API
WebSocket
gRPC

⚖️ 架构对比:专用 vs 通用

维度 专用适配器(每 Agent 一个) 通用适配器(Universal)
开发成本 N 个 Agent = N 个适配器 1 个适配器,配置驱动
维护成本 每个适配器单独维护 统一维护,一处修复全生效
新 Agent 接入 开发新适配器(1-2 周) 编写配置文件(1-2 小时)
协议支持 固定协议 MCP + A2A + 自定义,自动探测
扩展性 线性增长 插件化,无限扩展
一致性 各适配器可能不一致 统一标准,行为一致

🏗️ 系统架构

🎯 Agent 层

Hermes
Codex CLI
Claude Code
Cursor
任意 Agent

🔌 Universal Adapter

协议探测
能力发现
格式转换
统一封装

🕸️ Mesh Hub

Registry
Router
Load Balancer
Governance

📡 传输层

WebSocket
SSH Tunnel
gRPC
HTTP SSE

✨ 核心特性

🔌 通用适配器

  • 自动协议探测(MCP / A2A / REST / WebSocket)
  • 配置驱动,无需编码接入新 Agent
  • 能力自动发现与映射
  • 输入输出格式自动转换

🤝 双协议支持

  • A2A Protocol:Agent 发现、任务委托、生命周期管理
  • MCP Protocol:工具调用、资源访问、上下文注入
  • 协议间自动桥接转换
  • 向后兼容,渐进式迁移

🕸️ 智能路由

  • 基于能力的 Agent 匹配
  • 负载均衡与故障转移
  • 多跳路由支持
  • 延迟优化与缓存

📊 工作流引擎

  • DAG 可视化编排
  • 并行 / 串行 / 条件分支
  • 人工审批节点
  • 执行历史与回放

🔐 企业级治理

  • OAuth2 / JWT 认证
  • RBAC 细粒度权限
  • 完整审计日志
  • 速率限制与配额

📡 多传输协议

  • WebSocket(实时双向)
  • SSH Tunnel(安全加密)
  • gRPC(高性能)
  • HTTP SSE(轻量级)

📁 项目结构

agent-mesh-hub/
📄 package.json
📄 tsconfig.json
📄 README.md
📂 src/
📄 cli.ts 入口
📂 core/
📄 hub.ts Hub 核心
📄 registry.ts 注册中心
📄 router.ts 路由器
📂 adapter/
📄 universal.ts 通用适配器
📄 detector.ts 协议探测
📄 mapper.ts 能力映射
📄 converter.ts 格式转换
📂 protocol/
📄 a2a.ts A2A 协议
📄 mcp.ts MCP 协议
📄 bridge.ts 协议桥接
📂 transport/
📄 websocket.ts
📄 ssh.ts
📄 grpc.ts
📂 workflow/
📄 engine.ts 工作流引擎
📄 dag.ts DAG 定义
📂 config/
📄 agents/ Agent 配置
📄 workflows/ 工作流配置
📂 examples/
📄 hermes-codex.ts
📄 multi-agent-review.ts

🎯 核心模块

universal.ts 通用适配器核心,协调各子模块
detector.ts 自动探测 Agent 协议类型
mapper.ts 将 Agent 能力映射为标准格式
converter.ts 输入输出格式自动转换
bridge.ts A2A 与 MCP 协议桥接

🔌 接入方式

方式一:配置文件(推荐)

# config/agents/my-agent.yaml name: my-agent protocol: mcp # 或 a2a endpoint: http://localhost:8080 capabilities: - code-review - file-edit

方式二:自动发现

# 自动扫描网络中的 Agent mesh-hub discover --network 192.168.1.0/24

💡 使用示例

示例 1:接入新 Agent(配置文件)

# config/agents/hermes.yaml name: hermes type: mcp-server endpoint: stdio://hermes-mcp-server.py capabilities: - terminal - file-system - browser transport: ssh ssh: host: server.example.com port: 22 # 一键接入 mesh-hub agent add config/agents/hermes.yaml

示例 2:多 Agent 协作

// 定义工作流 const workflow = { name: "full-review", steps: [ { agent: "codex", action: "write-code" }, { agent: "claude", action: "security-review", needs: ["write-code"] }, { agent: "hermes", action: "deploy-test", needs: ["security-review"] } ] }; // 执行 mesh-hub workflow run full-review

示例 3:动态 Agent 选择

// 根据能力自动选择 Agent const result = await mesh.delegate({ capability: "code-review", // 自动匹配有该能力的 Agent task: "Review src/utils.ts", constraints: { maxLatency: 5000, // 5秒内响应 preferred: ["claude", "codex"] // 偏好顺序 } });

📅 开发路线图

Phase 1 — 核心框架

🎯 Hub + Universal Adapter 基础

实现 Registry、Router、Universal Adapter 核心框架

Registry Router Adapter Core
预计时间 1 周
Phase 2 — 协议层

🤝 A2A + MCP 双协议

实现协议探测、桥接、转换

A2A MCP Bridge
预计时间 1.5 周
Phase 3 — 传输层

📡 多传输协议

WebSocket、SSH、gRPC、HTTP SSE

WebSocket SSH gRPC
预计时间 1 周
Phase 4 — 工作流引擎

📊 DAG 编排

可视化工作流定义与执行

DAG Parallel Conditional
预计时间 1.5 周
Phase 5 — 企业特性

🔐 安全与治理

认证、授权、审计、监控

OAuth2 RBAC Audit
预计时间 1 周
Phase 6 — 生态建设

🌍 文档与社区

文档、示例、最佳实践

Docs Examples Blog
预计时间 持续

⚡ 快速开始

1️⃣

安装 Hub

npm install -g agent-mesh-hub
2️⃣

配置 Agent

# 创建配置文件 mesh-hub agent init my-agent
3️⃣

启动网络

mesh-hub start

🎉 接入后自动发现

所有配置的 Agent 将自动加入 Mesh 网络,无需手动配对!