Yapılandırılmış runbook'lar ve makbuzlar (receipts) aracılığıyla, kodlama ajanlarının tek bir makinede geliştirme yapmasına ve sonuçları farklı bir hedef host üzerinde doğrulamasına olanak tanır.
Ayrıca bilinen adı zarcherlot/code-relay, code-relay, code-relay-mcp
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 3.1.0
- Son commit
- 1 Eki 2026
- Lisans
- MIT
Code Relay MCP nedir?
Yapılandırılmış runbook'lar ve makbuzlar (receipts) aracılığıyla, kodlama ajanlarının tek bir makinede geliştirme yapmasına ve sonuçları farklı bir hedef host üzerinde doğrulamasına olanak tanır.
Özet, projenin README dosyasından oluşturuldu
Code Relay MCP sunucusu hakkında
Çalışmalarını farklı donanım veya ağ ortamlarında doğrulaması gereken kodlama ajanları, geliştirme ve doğrulama arasındaki boşluğu kapatmak için Code Relay'i kullanabilir. Bir geliştirme host'unu bir hedef host'a bağlayarak, bir yapay zeka ajanı bir makinede kod yazabilir ve bu kodun doğruluğunu anında bir Linux sunucusu, GPU içeren bir makine veya belirli sensörlere sahip bir cihaz gibi başka bir ortamda kanıtlayabilir. Bu kurulum; veritabanları, ödeme geri çağırmaları (callbacks) veya yerel olarak taklit edilmesi imkansız olan dahili servisler gibi gerçek entegrasyonların test edilmesine olanak tanır.
Sistem, stdio kullanarak yerel bir MCP server olarak çalışır; Claude Code, Cursor, VS Code ve Codex gibi istemcilerle uyumludur. Geliştiriciler, depoları bağlamak için bind_project ve doğrulama talimatlarını göndermek için publish_runbook gibi araçları kullanırlar. Hedef host bu talimatları yürütür ve yapılandırılmış bir receipt.json dosyası döndürür; ajan daha sonra alınan gerçek sonuçlara dayanarak kodu onarması ve tekrar denemesi gerekip gerekmediğine karar vermek için bu dosyayı analiz edebilir.
Neler yapabilirsiniz
- 1Özel donanım üzerinde kodu doğrulayınAjanın, model kodunu test etmek için CUDA GPU donanımlı bir makineye göndermesini isteyin.
- 2Platformlar arası uyumluluğu test edinAjanın macOS ortamında geliştirme yapmasını ve ardından bir Linux hedef host üzerinde doğrulama çalıştırmasını sağlayın.
- 3Yapay zeka destekli kod onarımlarını otomatize edinAjanın başarısız bir runbook receipt dosyasını analiz etmesi ve bir sonraki kontrolü geçmek için gerekli düzeltmeleri yapması talimatını verin.
- 4Karmaşık sistem entegrasyonlarını doğrulayınAjanı, kodun uzak bir host üzerindeki canlı veritabanları veya mesaj kuyrukları ile nasıl etkileşime girdiğini test etmesi için yönlendirin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Code Relay MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleCode Relay MCP'yi Claude Code içine yükleyin
$ claude mcp add code-relay -- npx -y code-relay-mcpCode Relay MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"code-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"code-relay","type":"stdio","command":"npx","args":["-y","code-relay-mcp"]}'Code Relay MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP'yi Codex içine yükleyin
$ codex mcp add code-relay -- npx -y code-relay-mcpCode Relay MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.code-relay] command = "npx" args = ["-y", "code-relay-mcp"]
Code Relay MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user code-relay npx -- -y code-relay-mcpCode Relay MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirzarcherlot/code-relay is public and reachablegithub.com/zarcherlot/code-relay ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorcode-relay-mcp names zarcherlot/code-relay as sourcenpmjs.com/package/code-relay-mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-01github.com/zarcherlot/code-relay ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from code-relay-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok1 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
Code Relay MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add code-relay -- npx -y code-relay-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Code Relay MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Code Relay ile hangi kodlama ajanları uyumludur?
Codex, Claude Code, Cursor, VS Code ve MCP yeteneğine sahip diğer kodlama ajanları ile çalışır.
Relay iş akışında Target Host'un amacı nedir?
Target Host, gerçek ortamdaki tam kaynak commit'ini kontrol eden bir Checkpoint görevi görür ve sonucu kaydeden bir Receipt döndürür.