Memungkinkan coding agent untuk melakukan pengembangan di satu mesin dan memverifikasi hasilnya pada target host yang berbeda melalui runbook dan receipt yang terstruktur.
Juga dikenal sebagai zarcherlot/code-relay, code-relay, code-relay-mcp
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 3.1.0
- Commit terakhir
- 1 Okt 2026
- Lisensi
- MIT
Apa itu Code Relay MCP?
Memungkinkan coding agent untuk melakukan pengembangan di satu mesin dan memverifikasi hasilnya pada target host yang berbeda melalui runbook dan receipt yang terstruktur.
Ringkasan dibuat dari README proyek
Tentang Code Relay MCP server
Coding agent yang perlu memverifikasi hasil kerjanya pada hardware atau lingkungan jaringan yang berbeda dapat menggunakan Code Relay untuk menjembatani celah antara pengembangan dan validasi. Dengan menghubungkan development host ke target host, AI agent dapat menulis kode di satu mesin dan segera membuktikan kebenarannya di mesin lain, seperti server Linux, mesin dengan GPU, atau perangkat dengan sensor spesifik. Setup ini memungkinkan pengujian integrasi nyata seperti database, payment callback, atau layanan internal yang mustahil direplikasi secara lokal.
Sistem ini beroperasi sebagai local MCP server menggunakan stdio dan kompatibel dengan client seperti Claude Code, Cursor, VS Code, dan Codex. Developer menggunakan tool seperti bind_project untuk menghubungkan repositori dan publish_runbook untuk mengirim instruksi validasi. Target host akan mengeksekusi instruksi tersebut dan mengembalikan file receipt.json terstruktur, yang kemudian dapat dianalisis oleh agent untuk menentukan apakah perlu melakukan perbaikan dan mencoba kembali kode berdasarkan hasil aktual yang diterima.
Apa yang bisa Anda lakukan dengannya
- 1Verifikasi kode pada hardware khususMinta agent untuk mengirimkan kode model ke mesin yang dilengkapi dengan CUDA GPU untuk pengujian.
- 2Uji kompatibilitas lintas platformBiarkan agent melakukan pengembangan di lingkungan macOS dan kemudian menjalankan validasi pada target host Linux.
- 3Otomatisasi perbaikan kode berbasis AIInstruksikan agent untuk menganalisis receipt runbook yang gagal dan melakukan perbaikan yang diperlukan agar lolos pengecekan berikutnya.
- 4Validasi integrasi sistem yang kompleksArahkan agent untuk menguji bagaimana kode berinteraksi dengan database live atau message queue pada host remote.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Code Relay MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Code Relay MCP di Claude Code
$ claude mcp add code-relay -- npx -y code-relay-mcpInstal Code Relay MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instal Code Relay MCP di VS Code
.vscode/mcp.json
{
"servers": {
"code-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instal Code Relay MCP di VS Code CLI
$ code --add-mcp '{"name":"code-relay","type":"stdio","command":"npx","args":["-y","code-relay-mcp"]}'Instal Code Relay MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instal Code Relay MCP di Codex
$ codex mcp add code-relay -- npx -y code-relay-mcpInstal Code Relay MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.code-relay] command = "npx" args = ["-y", "code-relay-mcp"]
Instal Code Relay MCP di Gemini CLI
$ gemini mcp add -s user code-relay npx -- -y code-relay-mcpInstal Code Relay MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauzarcherlot/code-relay is public and reachablegithub.com/zarcherlot/code-relay ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyacode-relay-mcp names zarcherlot/code-relay as sourcenpmjs.com/package/code-relay-mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-01github.com/zarcherlot/code-relay ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from code-relay-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubCode 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.
Pertanyaan tentang Code Relay MCP
Bagaimana cara menambahkan Code Relay MCP ke Claude Code?
Jalankan claude mcp add code-relay -- npx -y code-relay-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Code Relay MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Coding agent apa saja yang kompatibel dengan Code Relay?
Code Relay bekerja dengan Codex, Claude Code, Cursor, VS Code, dan coding agent berbasis MCP lainnya.
Apa fungsi Target Host dalam workflow Relay?
Target Host bertindak sebagai Checkpoint, yang memeriksa commit source secara tepat di lingkungan aslinya dan mengembalikan Receipt yang mencatat hasilnya.