구조화된 runbook과 receipt를 통해 코딩 에이전트가 한 대의 머신에서 개발하고 다른 타겟 호스트에서 결과를 검증할 수 있도록 지원합니다.
다른 이름 zarcherlot/code-relay, code-relay, code-relay-mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 3.1.0
- 마지막 커밋
- 2026년 10월 1일
- 라이선스
- MIT
Code Relay MCP란?
구조화된 runbook과 receipt를 통해 코딩 에이전트가 한 대의 머신에서 개발하고 다른 타겟 호스트에서 결과를 검증할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Code Relay MCP server 정보
서로 다른 하드웨어나 네트워크 환경에서 작업 내용을 검증해야 하는 코딩 에이전트는 Code Relay를 사용하여 개발과 검증 사이의 간극을 메울 수 있습니다. 개발 호스트를 타겟 호스트에 연결하면 AI 에이전트가 한 대의 머신에서 코드를 작성하고, Linux 서버, GPU가 장착된 머신 또는 특정 센서가 있는 장치와 같은 다른 환경에서 즉시 코드의 정확성을 증명할 수 있습니다. 이러한 설정은 로컬에서 재현이 불가능한 데이터베이스, 결제 콜백 또는 내부 서비스와 같은 실제 통합 테스트를 가능하게 합니다.
이 시스템은 stdio를 사용하는 로컬 MCP server로 작동하며 Claude Code, Cursor, VS Code, Codex와 같은 클라이언트와 호환됩니다. 개발자는 bind_project를 사용하여 리포지토리를 연결하고, publish_runbook을 사용하여 검증 지침을 전송합니다. 타겟 호스트는 이러한 지침을 실행하고 구조화된 receipt.json 파일을 반환하며, 에이전트는 수신된 실제 결과를 분석하여 코드를 수정하고 다시 시도해야 하는지 결정할 수 있습니다.
활용 사례
- 1특수 하드웨어에서 코드 검증에이전트에게 모델 코드를 CUDA GPU가 장착된 머신으로 전송하여 테스트하도록 요청합니다.
- 2크로스 플랫폼 호환성 테스트에이전트가 macOS 환경에서 개발한 후 Linux 타겟 호스트에서 검증을 수행하도록 합니다.
- 3AI 기반 코드 수정 자동화에이전트가 실패한 runbook receipt를 분석하고 다음 체크를 통과하기 위해 필요한 수정을 수행하도록 지시합니다.
- 4복잡한 시스템 통합 검증에이전트가 원격 호스트의 라이브 데이터베이스 또는 메시지 큐와 코드가 어떻게 상호작용하는지 테스트하도록 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Code Relay MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Code Relay MCP 설치
$ claude mcp add code-relay -- npx -y code-relay-mcpCursor에 Code Relay MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}VS Code에 Code Relay MCP 설치
.vscode/mcp.json
{
"servers": {
"code-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}VS Code CLI에 Code Relay MCP 설치
$ code --add-mcp '{"name":"code-relay","type":"stdio","command":"npx","args":["-y","code-relay-mcp"]}'Claude Desktop에 Code Relay MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Codex에 Code Relay MCP 설치
$ codex mcp add code-relay -- npx -y code-relay-mcpCodex config.toml에 Code Relay MCP 설치
~/.codex/config.toml
[mcp_servers.code-relay] command = "npx" args = ["-y", "code-relay-mcp"]
Gemini CLI에 Code Relay MCP 설치
$ gemini mcp add -s user code-relay npx -- -y code-relay-mcpGemini settings.json에 Code Relay MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능zarcherlot/code-relay is public and reachablegithub.com/zarcherlot/code-relay ↗통과
- 패키지가 이 저장소를 소스로 명시code-relay-mcp names zarcherlot/code-relay as sourcenpmjs.com/package/code-relay-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-01github.com/zarcherlot/code-relay ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from code-relay-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음1 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Code Relay lets your coding agent develop on one machine and prove the result on another.
Relay is an MCP-based coding-agent integration for cross-machine development and verification. AI on the Dev Host implements the request; the Target Host runs the real validation; a structured receipt comes back to guide the next repair iteration. It works with Codex, Claude Code, Cursor, VS Code, and other MCP-capable coding agents.
When Relay is useful
- Different environments — develop on Windows or macOS, verify on Linux, a private network, or a production-like host.
- Special hardware — send model code to a CUDA/GPU machine, or verify a camera, serial device, or sensor where it is connected.
- Real integrations — exercise payment callbacks, queues, databases, browsers, or internal services that cannot be reproduced locally.
- AI-driven iteration — return concrete expected/actual results so the coding agent can repair, republish, and retry.
What Relay provides
- Branch-scoped project binding and short-lived join links.
- Exact source-commit verification in an isolated worktree.
- Checkpoint execution through a
code-relay-checkpointGitHub Actions self-hosted runner. - Safe, allowlisted validation commands with bounded output and timeouts.
- Structured
receipt.jsonand human-readable receipts for passed, failed, and blocked runs.
Quick start
AI client installation
Let your coding agent read and follow the instructions:
https://raw.githubusercontent.com/zarcherlot/code-relay/main/install.md
npm fallback
npx -y code-relay-mcp@latest install --client codex
Replace codex with claude-code, cursor, vscode, or generic as needed.
MCP server details
Code Relay is a local MCP server that communicates over stdio. The npm package starts the server with:
npx -y code-relay-mcp@3.1.0
The server implements the MCP JSON-RPC surface directly in Go (without a
third-party MCP SDK). It supports initialize, ping, tools/list, and
tools/call, and exposes these tools:
| Tool | Purpose |
|---|---|
bind_project |
Bind a repository and branch to a relay role. |
create_checkpoint_invite |
Create a short-lived checkpoint join link. |
join_checkpoint |
Join a branch-scoped checkpoint subscription. |
watcher_status |
Read local watcher state. |
stop_watcher |
Stop the local watcher. |
doctor |
Run non-mutating local health checks. |
publish_runbook |
Validate and publish a runbook. |
status |
Read runbook and receipt status. |
fetch_receipt |
Load and validate a runbook receipt. |
analyze |
Analyze a receipt and determine the next state. |
The implementation and transport loop are in internal/relay/mcp.go.
How it works
the Dev Host sends a repository- and branch-bound runbook through Relay; the Target Host checks the exact source commit in its real environment and returns a Receipt recording the Checkpoint result.
Every runbook is bound to a repository, branch, and source commit. The Target Host acts as the Checkpoint, and the resulting receipt records passed, failed, or blocked verification for the next iteration.
Documentation
- Chinese README
- User guide
- AI-client installation guide
- Local desktop install runbook
- Deployment and runbook
- Security
- Contributing
License
Code Relay is released under the MIT License.
Code Relay MCP 질문
Code Relay MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add code-relay -- npx -y code-relay-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Code Relay MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Code Relay와 호환되는 코딩 에이전트는 무엇인가요?
Codex, Claude Code, Cursor, VS Code 및 기타 MCP 지원 코딩 에이전트와 함께 사용할 수 있습니다.
Relay 워크플로우에서 Target Host의 역할은 무엇인가요?
Target Host는 Checkpoint 역할을 수행하며, 실제 환경에서 정확한 소스 커밋을 확인하고 결과를 기록한 Receipt를 반환합니다.