mcp-acp-bridge

MCP를 사용하는 모든 코딩 에이전트를 앞에 두는 ACP 서버입니다.

브리지는 에이전트를 위한 MCP 서버를 호스팅하고, 편집기나 클라이언트와 ACP로 통신합니다. 에이전트가 만드는 모든 도구 호출이 브리지를 통과하기 때문에, 브리지는 각 호출을 보류하고 먼저 클라이언트에게 승인을 요청할 수 있습니다. 이는 도구 호출을 UI가 제공하는 실제 권한 프롬프트로 전환합니다.

client (T3 Code, Zed, …) ──ACP──► bridge ──MCP──► agent (agy, claude, codex, …)
                                    │
                                    └─ spawns and supervises the agent process

상태: MCP 부분은 작동합니다. ACP 부분은 아직 존재하지 않습니다.

도구 가로채기 및 권한 게이팅은 라이브 MCP 클라이언트인 Claude Code를 대상으로 종단 간 구현 및 검증되었습니다. 호출이 가로채지고, 보류되며, 허용 또는 거부되고, 거부는 읽을 수 있는 텍스트로 에이전트에 반환됩니다. 누락된 것은 이러한 보류를 실제 클라이언트를 위한 session/request_permission으로 전환하는 ACP 서버와 에이전트 감독자입니다. docs/design.md를 참조하세요.

사용해보기

npm install
npm test              # unit tests, no agent required
npm run test:live     # drives the real `claude` CLI against the gateway
npm run test:live deny

test:live는 PATH에 claude CLI가 있고 인증되어 있어야 합니다. Claude Code에 세션별 MCP 엔드포인트를 제공하고, 도구를 호출하도록 요청한 후 가로채기를 보여줍니다:

[tool] requested magic_word
[gate] DENY magic_word {}
[tool] denied magic_word (denied by test policy)
[claude] said: The tool call was denied. The error returned was exactly:
         `Error: permission denied: denied by test policy`

Related MCP server: agentic-governance-gateway

이유

일부 코딩 에이전트는 구조화된 출력을 내보내지 않습니다. Google의 Antigravity CLI(agy)가 동기 사례입니다. ACP 모드가 없으며(업스트림 요청), 헤드리스 모드에서는 일반 텍스트를 출력하고 프롬프트할 수 없는 모든 권한을 자동 거부합니다. 따라서 GUI에서 이를 구동하려면 TUI를 스크래핑하거나 승인을 포기해야 합니다.

이 브리지는 세 번째 경로를 취합니다. 에이전트가 말하는 것은 무시하고 에이전트가 하는 것을 가로챕니다. MCP 도구 호출은 이미 구조화되어 있고, 관찰 가능하며, 결정적으로 이미 가로챌 수 있습니다. MCP 서버는 리스너가 아니라 게이트입니다.

이 접근 방식에는 에이전트 특화된 부분이 없습니다. MCP 서버를 가리킬 수 있는 모든 에이전트가 작동합니다.

보는 것과 보지 않는 것

MCP는 도구 채널이지 에이전트 출력 채널이 아닙니다.

에이전트의 내장 파일 및 셸 도구는 MCP를 통과하지 않으므로 tool_call을 발생시키지 않습니다. 이는 가시성 격차이지 정확성 문제가 아닙니다. 작업 공간을 체크포인트하는 클라이언트(T3 Code는 턴 경계에서 diff를 기록)는 여전히 변경된 내용을 기록합니다. 손실되는 것은 실시간 작업별 진행 상황이지 기록이 아닙니다.

내장 도구를 브리지를 통해 MCP 도구로 라우팅하면 그 격차를 해소하고 보안 모델을 상시 허가에서 작업별 검토로 업그레이드합니다. 이는 계획된 강화이며, 필수 조건이 아닙니다.

MCP 개정 지원

현재 개정과 다가오는 개정 모두 지원됩니다. 브리지는 MCP 전송 상태에 대해 아무것도 키잉하지 않기 때문입니다.

ACP 세션은 에이전트 실행당 하나의 경로 범위 엔드포인트 URL로 상관 관계가 지정되므로 두 개정 모두 동일하게 동작합니다. docs/design.md를 참조하세요.

라이선스

MIT. LICENSE를 참조하세요.