Ia Bridge MCP

ia桥mcp

一种模型上下文协议（MCP）服务器，支持以下对象之间的结构化协作 克劳德 和 法典 --两个独立的人工智能助手一起审查你的代码或决策，直到合适的时候才看到对方的工作。

它做什么

/second-opinion --要求一位审阅者（克劳德或Codex）对任务、补丁或决定进行结构化的评论。按严重程度、置信水平和未知因素返回结果。

/forum --运行完整的三轮同行评审协议：

Round 1: Claude and Codex each propose a solution independently
Round 2: Claude critiques Codex's proposal; Codex critiques Claude's
Round 3: Codex synthesizes both proposals + critiques into a final recommendation

两个命令都运行 异步地 --审查在后台进行，您可以在等待的同时继续工作。所有会话都保存为markdown文件 ~/.bridge-ai/.

先决条件

• 克劳德代码 (claude CLI）
• Codex CLI (codex CLI）
• Node.js≥18
• npm
• Python 3

安装

git clone https://github.com/AlterMundi/ia-bridge-mcp.git
cd ia-bridge-mcp
./install.sh

安装程序将：

1. 跑 npm install 获取MCP SDK
2. 使用Claude Code注册本地插件市场
3. 安装 peer-opinion 插件（提供 /second-opinion 和 /forum 斜线命令）
4. 使用Claude Code和Codex CLI注册MCP服务器
5. 创建符号链接 ~/.local/bin/second-opinion 和 ~/.local/bin/forum 用于直接CLI使用
6. 创建 ~/.bridge-ai/{opinions,sessions,jobs}/ 用于存储输出

注： Codex可以显示 Auth: Unsupported 对于stdio MCP，这是预期的，不会影响功能。

用法

内部Claude代码（斜线命令）

/second-opinion Review this authentication patch
/second-opinion codex Should we use Redis or Postgres for session storage?
/forum Design a safer rollout strategy for this migration

从终端（CLI）

second-opinion --task "Review this patch"
second-opinion --reviewer codex --task "Review this patch"
forum --task "Design safer rollout" --constraints "must be backward-compatible"

来自任何支持MCP的客户端（工具）

上下文是自动检测的：在git存储库中，服务器捕获分支、最近提交和当前差异，并将其传递给两个审阅者。

会话工件

所有输出都保存为纯markdown：

~/.bridge-ai/
├── opinions/          # /second-opinion outputs
│   └── 20260316--claude-second-opinion.md
├── sessions/          # /forum 3-round sessions
│   └── 20260316-/
│       ├── 00-shared-context.md
│       ├── 10-claude-round1.md
│       ├── 20-codex-round1.md
│       ├── 30-claude-critiques-codex.md
│       ├── 40-codex-critiques-claude.md
│       ├── 50-final-synthesis.md
│       └── INDEX.md
└── jobs/              # job metadata and logs

A. /forum 会话可以是 恢复 如果中断：

forum --resume ~/.bridge-ai/sessions/20260316-myrepo

运作原理

ia-bridge-mcp (Node.js stdio MCP server)
  ├── registered in Claude Code MCP config
  ├── registered in Codex CLI MCP config
  └── exposes 6 tools (ia_bridge_run, single_opinion_run, status, result, list, read)

peer-opinion plugin (Claude Code plugin)
  ├── /second-opinion  →  single_opinion_run tool
  └── /forum           →  ia_bridge_run tool

CLI wrappers (~/.local/bin/)
  ├── second-opinion   →  second-opinion-via-mcp.sh  →  Python MCP client
  └── forum            →  forum-via-mcp.sh            →  Python MCP client

服务器本身是一个使用stdio传输的轻量级Node.js进程。它为每次审查运行生成后台shell作业，并公开轮询工具，以便Claude或任何其他MCP客户端可以检查进度并检索结果而不会阻塞。

存储库布局

ia-bridge-mcp/
├── install.sh                          # one-step installer
├── uninstall.sh                        # clean uninstaller
├── mcp/
│   ├── ia_bridge_mcp_server.mjs        # MCP server (Node.js, stdio)
│   ├── mcp_tool_call.py                # Python client for CLI wrappers
│   └── package.json                    # single dependency: @modelcontextprotocol/sdk
└── marketplace/
    └── plugins/peer-opinion/
        ├── scripts/
        │   ├── forum.sh                # 3-round bridge protocol
        │   ├── second-opinion.sh       # single-pass opinion
        │   ├── forum-via-mcp.sh        # CLI wrapper (calls MCP server)
        │   └── second-opinion-via-mcp.sh
        └── commands/
            ├── forum.md                # /forum slash command definition
            └── second-opinion.md       # /second-opinion slash command definition

隐私声明

在git存储库中运行时，这两个脚本都会捕获您当前的分支、最近的提交和 git diff HEAD 并将它们包含在发送给Claude（Anthropic API）和Codex（OpenAI API）的提示中。没有数据发送到任何其他服务。如果您正在使用敏感代码，请在使用前查看API提供商的数据处理策略。

卸载

cd ia-bridge-mcp
./uninstall.sh

这将删除MCP注册、插件、市场入口和符号链接。您的会话已登录 ~/.bridge-ai/ 被保存。

许可证

麻省理工学院——见 AlterMundi