Hermes-Codex Bridge 项目规划

📋 项目概述

Hermes-Codex Bridge 是一个双向 MCP (Model Context Protocol) 桥接器，让运行在不同机器上的 Hermes Agent（服务器端）和 Codex CLI（本地端）能够互相调用对方的工具和能力，实现真正的分布式 Agent 协作。

🎯 核心目标

Codex 可以调用 Hermes 的服务器工具（终端、文件、浏览器等）
Hermes 可以调用 Codex 的代码能力（分析、审查、实现）
支持 SSH 隧道和 WebSocket 两种连接方式
零侵入式集成，无需修改现有 Agent 代码

📊 项目状态

架构设计 100%

核心开发 0%

测试验证 0%

文档发布 0%

🏗️ 系统架构

💻 本地电脑

Codex CLI

MCP Client

Bridge Server

运行用户本地环境
代码编辑、分析、审查

⇄

SSH Tunnel / WebSocket
MCP Protocol (JSON-RPC)

🖥️ 服务器

Hermes Agent

MCP Server

Bridge Client

运行服务器环境
终端操作、文件管理、浏览器

🔄 工作流程

1

用户发起请求

用户在 Codex CLI 中输入指令，例如："让 Hermes 查看服务器日志"

2

Codex 识别工具调用

Codex 识别需要调用远程工具，通过 MCP 协议发送工具调用请求到 Bridge

3

Bridge 路由转发

Bridge 接收请求，通过 SSH/WebSocket 转发到服务器端的 Hermes Agent

4

Hermes 执行工具

Hermes 在服务器上执行相应工具（终端命令、文件操作等），返回结果

5

结果返回用户

结果通过 Bridge 返回给 Codex，Codex 整合后展示给用户

📁 项目结构

hermes-codex-bridge/

📄 package.json

📄 tsconfig.json

📄 README.md

📂 src/

📄 cli.ts 入口

📂 commands/

📄 serve.ts

📄 setup.ts

📄 install.ts

📂 server/

📄 codex-server.ts MCP Server

📄 hermes-client.ts MCP Client

📂 bridge/

📄 connection.ts SSH/WS

📄 protocol.ts

📄 router.ts

📂 lib/

📄 exec-runner.ts

📄 output-parser.ts

📄 logger.ts

📂 types/

📄 index.ts

📂 skills/

📂 codex-teammate/

📂 hermes-teammate/

📂 scripts/

📄 install.sh

📄 setup.sh

🔧 核心模块说明

cli.ts	CLI 入口，解析命令
codex-server.ts	Codex 侧 MCP Server，暴露 Codex 工具
hermes-client.ts	Hermes 侧 MCP Client，调用 Hermes 工具
connection.ts	连接管理（SSH 隧道 / WebSocket）
router.ts	消息路由，转发工具调用

📦 依赖技术

@modelcontextprotocol/sdk TypeScript ssh2 ws (WebSocket) zod execa

📅 开发计划

Phase 1 — 基础架构

🔧 核心桥接功能

实现 MCP Server/Client 基础通信，支持 stdio 和 WebSocket 传输

MCP Protocol Tool Discovery Basic Routing

Phase 2 — 连接层

🔌 SSH 隧道 + WebSocket

实现安全的远程连接，支持 SSH 密钥认证和 WebSocket 实时通信

SSH2 WebSocket Auto Reconnect

Phase 3 — 工具适配

🛠️ Hermes 工具暴露

将 Hermes 的终端、文件、浏览器等工具通过 MCP 暴露给 Codex

Terminal File System Browser

Phase 4 — 反向调用

⚡ Codex 能力暴露

将 Codex 的代码分析、审查、实现能力暴露给 Hermes

Code Review Implementation Analysis

Phase 5 — 用户体验

✨ 一键安装配置

提供自动化安装脚本和交互式配置向导

CLI Setup Auto Config Skill Install

Phase 6 — 测试发布

🚀 测试与文档

完整测试、性能优化、文档编写和 npm 发布

Unit Test E2E Test Documentation

💡 使用示例

场景 1：Codex 调用 Hermes

# 用户在 Codex CLI 中输入
"让 Hermes 查看服务器上的 /var/log/nginx/error.log 最后 100 行"

# Codex 自动调用 bridge 工具
hermes_terminal({
  command: "tail -100 /var/log/nginx/error.log"
})

# 结果返回给 Codex 展示
                

场景 2：Hermes 调用 Codex

# 用户在 Hermes 中输入
"让 Codex 审查一下这段代码的性能问题"

# Hermes 自动调用 bridge 工具
codex_review_code({
  target: "src/utils/processor.ts",
  focusAreas: "performance"
})

# Codex 审查结果返回给 Hermes
                

⚡ 快速开始

1️⃣ 安装 Bridge

npm install -g hermes-codex-bridge

2️⃣ 一键配置

hermes-codex-bridge setup

3️⃣ 启动服务

hermes-codex-bridge serve

🎉 配置完成后

Codex 和 Hermes 将自动发现对方工具，无需手动干预！

📚 参考项目

项目	描述	参考价值
claude-codex-bridge	Claude Code 和 Codex CLI 的双向桥接	核心架构参考、MCP 实现模式
hermes-mcp	Hermes Agent 的 MCP Server 暴露	Hermes 工具发现与调用机制
tmux-bridge-mcp	基于 tmux 的多 Agent 通信	本地多 Agent 协作模式
Google A2A Protocol	Agent-to-Agent 开放协议标准	未来标准化方向