Ermöglicht es Coding Agents, auf einer Maschine zu entwickeln und die Ergebnisse über strukturierte Runbooks und Receipts auf einem anderen Target Host zu verifizieren.
Auch bekannt als zarcherlot/code-relay, code-relay, code-relay-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 3.1.0
- Letzter Commit
- 1. Okt. 2026
- Lizenz
- MIT
Was ist Code Relay MCP?
Ermöglicht es Coding Agents, auf einer Maschine zu entwickeln und die Ergebnisse über strukturierte Runbooks und Receipts auf einem anderen Target Host zu verifizieren.
Zusammenfassung generiert aus dem README des Projekts
Über Code Relay MCP server
Coding Agents, die ihre Arbeit auf unterschiedlicher Hardware oder in anderen Netzwerkumgebungen verifizieren müssen, können Code Relay nutzen, um die Lücke zwischen Entwicklung und Validierung zu schließen. Durch die Verbindung eines Development Hosts mit einem Target Host kann ein AI Agent Code auf einer Maschine schreiben und sofort dessen Korrektheit auf einer anderen beweisen, wie etwa einem Linux-Server, einer Maschine mit einer GPU oder einem Gerät mit spezifischen Sensoren. Dieses Setup ermöglicht das Testen echter Integrationen wie Datenbanken, Payment Callbacks oder internen Services, die lokal nicht repliziert werden können.
Das System arbeitet als lokaler MCP server über stdio und ist kompatibel mit Clients wie Claude Code, Cursor, VS Code und Codex. Entwickler nutzen Tools wie bind_project, um Repositories zu verknüpfen, und publish_runbook, um Validierungsanweisungen zu senden. Der Target Host führt diese Anweisungen aus und gibt eine strukturierte receipt.json Datei zurück, die der Agent anschließend analysieren kann, um zu entscheiden, ob er den Code basierend auf den erhaltenen Ergebnissen reparieren und erneut versuchen muss.
Was du damit machen kannst
- 1Code auf spezialisierter Hardware verifizierenLass den Agenten Model-Code an eine Maschine mit einer CUDA GPU zum Testen senden.
- 2Plattformübergreifende Kompatibilität testenLass den Agenten in einer macOS-Umgebung entwickeln und die Validierung anschließend auf einem Linux Target Host ausführen.
- 3KI-gesteuerte Code-Repairs automatisierenAnweisung an den Agenten, einen fehlgeschlagenen Runbook Receipt zu analysieren und die notwendigen Fixes durchzuführen, um den nächsten Check zu bestehen.
- 4Komplexe Systemintegrationen validierenLeite den Agenten an zu testen, wie der Code mit Live-Datenbanken oder Message Queues auf einem Remote Host interagiert.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Code Relay MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenCode Relay MCP in Claude Code installieren
$ claude mcp add code-relay -- npx -y code-relay-mcpCode Relay MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"code-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"code-relay","type":"stdio","command":"npx","args":["-y","code-relay-mcp"]}'Code Relay MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Code Relay MCP in Codex installieren
$ codex mcp add code-relay -- npx -y code-relay-mcpCode Relay MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.code-relay] command = "npx" args = ["-y", "code-relay-mcp"]
Code Relay MCP in Gemini CLI installieren
$ gemini mcp add -s user code-relay npx -- -y code-relay-mcpCode Relay MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarzarcherlot/code-relay is public and reachablegithub.com/zarcherlot/code-relay ↗Bestanden
- Paket nennt dieses Repository als Quellecode-relay-mcp names zarcherlot/code-relay as sourcenpmjs.com/package/code-relay-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-01github.com/zarcherlot/code-relay ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from code-relay-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenCode 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 Fragen
Wie füge ich Code Relay MCP zu Claude Code hinzu?
Führe claude mcp add code-relay -- npx -y code-relay-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Code Relay MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Coding Agents sind mit Code Relay kompatibel?
Es funktioniert mit Codex, Claude Code, Cursor, VS Code und anderen MCP-fähigen Coding Agents.
Was ist der Zweck des Target Host im Relay-Workflow?
Der Target Host fungiert als Checkpoint, prüft den exakten Source Commit in seiner realen Umgebung und gibt einen Receipt zurück, der das Ergebnis dokumentiert.