convez.ai
MCP Server
0x000x7f

codex-cli-mcp-bridge

0x000x7f/codex-cli-mcp-bridge

Ver no GitHub
InicialPluginScore · de 0 a 100

Design-phase MCP bridge concept for automating Codex CLI handoff workflows

Instalação

$npx convez-ai 0x000x7f/codex-cli-mcp-bridge

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 4 meses
Versão
—
Issues abertas
1
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

codex-cli-mcp-bridge

Status: experimental — Phases 1–3 implemented and verified (codex_plan / codex_propose_patch read-only; codex_apply applies a reviewed diff only with explicit approval; the working tree stays unchanged on every read-only path and on every rejection). Not an official Anthropic / OpenAI project.

EN — An experimental MCP server bridging Codex CLI into Claude Code, automating the manual Markdown-handoff workflow of claude-code-agent-workflow. Three staged tools isolate mutation behind an explicit approval gate: codex_plan (read-only, implemented) → codex_propose_patch (returns a validated Git unified diff plus its diff_sha256 / base_head, verified with git apply --check, never applied — implemented) → codex_apply (applies a reviewed exact diff; requires explicit approval plus diff-hash and HEAD binding; does not call Codex — implemented).

Claude Code から Codex CLI を MCP ツールとして呼び出し、 claude-code-agent-workflow の /handoff(Markdown 手動運搬)を自動化する実験的ブリッジ(Phase 1–3 実装済み)。

なぜ作るか

  • 現状: HANDOFF 文書を人間が Codex / Cursor へコピーして運搬し、戻り差分を /review-diff で検収している
  • 目標: この運搬を MCP ツール呼び出しに置き換え、「ハンドオフ生成 → Codex 実行 → 差分検収」を1フローにする
  • ただし、MCP ツール化で最も危険な自動ファイル変更は最終 Phase まで隔離する

3段階のツール設計

ツールPhaseできることできないこと
codex_plan(handoff_path)1HANDOFF 文書を Codex に読ませ、要約と実装計画を返すファイル変更の一切
codex_propose_patch(handoff_path)2検証済み unified diff 案+diff_sha256/base_head/レビューヒントを返す(Git 形式・パス guard・上限 → git apply --check)working tree への適用
codex_apply(diff, approval, expected_sha256, base_head)3レビュー済み exact diff を working tree に適用(Codex は呼ばない・hash/HEAD 束縛・clean tree 必須)承認なしの適用・stage・commit
codex_review_patch(diff, expected_sha256, base_head, review_focus?)4別 Codex に diff を read-only 第三者レビューさせ written verdict を返す(助言のみ・diff を hash/HEAD で束縛)ファイル変更・apply・承認の代替

Roadmap

  • Phase 0: 設計・セキュリティモデル・既存方式との比較
  • Phase 1: codex_plan(読み取り専用ツール)の実装と検証 — 実走前後で working tree 不変を確認済み
  • Phase 2: codex_propose_patch(diff 提案のみ)— 当初 Strategy A(手書き diff)で実装
  • Phase 2B′: Strategy B′(temp worktree + bridge-applied writes)へ移行 — 既存ファイル変更の apply --check 通過率を 29% → 100% に改善(field test)。native Windows の codex-exec 書き込みブロックを迂回
  • Phase 3: codex_apply(review-first の承認ゲート)— Codex を呼ばず、人間がレビューした exact diff のみを適用。approval=true + diff の SHA-256 + base HEAD で束縛し、clean tree 必須・適用直前に再検証・working tree のみ(stage/commit しない)。非ASCII記号の文字化けは propose の review ヒント表示+人間レビューで吸収
  • Phase 4: codex_review_patch(第三者レビュー・read-only・任意レイヤー)— 別の Codex に diff を read-only でレビューさせ written verdict を返す。助言のみで apply ゲートには非関与(mutating tool は codex_apply のまま)。mojibake 判定は相関故障のため低信頼(人間レビューが本丸)
  • Phase 3/4 運用検証の積み増し(propose→review→apply 往復の field test を複数)
  • クロスエージェント自動レビューループ

ドキュメント

前提環境(Phase 1 以降で使用)

  • Codex CLI installed locally
  • Node.js 24+ / npm 11+(MCP server は TypeScript を想定)

Related project

  • claude-code-agent-workflow — 安定版のワークフローテンプレート。本ブリッジが不調でも Markdown handoff 方式で運用が成立する(フォールバック関係)

License

MIT

Ver o original no GitHub

Bom para

Relacionados