Permite que los agentes de programación desarrollen en una máquina y verifiquen los resultados en un host de destino diferente mediante runbooks y recibos estructurados.
También conocido como zarcherlot/code-relay, code-relay, code-relay-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 3.1.0
- Último commit
- 1 oct 2026
- Licencia
- MIT
¿Qué es Code Relay MCP?
Permite que los agentes de programación desarrollen en una máquina y verifiquen los resultados en un host de destino diferente mediante runbooks y recibos estructurados.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Code Relay
Los agentes de programación que necesitan verificar su trabajo en diferentes entornos de hardware o red pueden usar Code Relay para cerrar la brecha entre el desarrollo y la validación. Al conectar un host de desarrollo con un host de destino, un agente de IA puede escribir código en una máquina y demostrar inmediatamente su corrección en otra, como un servidor Linux, una máquina con GPU o un dispositivo con sensores específicos. Esta configuración permite probar integraciones reales como bases de datos, callbacks de pagos o servicios internos que son imposibles de replicar localmente.
El sistema opera como un MCP server local usando stdio y es compatible con clientes como Claude Code, Cursor, VS Code y Codex. Los desarrolladores utilizan herramientas como bind_project para vincular repositorios y publish_runbook para enviar instrucciones de validación. El host de destino ejecuta estas instrucciones y devuelve un archivo receipt.json estructurado, que el agente puede analizar para determinar si necesita reparar y reintentar el código basándose en los resultados reales recibidos.
Qué puedes hacer con él
- 1Verificar código en hardware especializadoPide al agente que envíe el código del modelo a una máquina equipada con una GPU CUDA para realizar pruebas.
- 2Probar la compatibilidad multiplataformaHaz que el agente desarrolle en un entorno macOS y luego ejecute la validación en un host de destino Linux.
- 3Automatizar reparaciones de código impulsadas por IAInstruye al agente para que analice un recibo de un runbook fallido y realice las correcciones necesarias para superar la siguiente comprobación.
- 4Validar integraciones de sistemas complejosDirige al agente para que pruebe cómo el código interactúa con bases de datos en vivo o colas de mensajes en un host remoto.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Code Relay MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Code Relay MCP en Claude Code
$ claude mcp add code-relay -- npx -y code-relay-mcpInstalar Code Relay MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instalar Code Relay MCP en VS Code
.vscode/mcp.json
{
"servers": {
"code-relay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instalar Code Relay MCP en VS Code CLI
$ code --add-mcp '{"name":"code-relay","type":"stdio","command":"npx","args":["-y","code-relay-mcp"]}'Instalar Code Relay MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Instalar Code Relay MCP en Codex
$ codex mcp add code-relay -- npx -y code-relay-mcpInstalar Code Relay MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.code-relay] command = "npx" args = ["-y", "code-relay-mcp"]
Instalar Code Relay MCP en Gemini CLI
$ gemini mcp add -s user code-relay npx -- -y code-relay-mcpInstalar Code Relay MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-relay": {
"command": "npx",
"args": [
"-y",
"code-relay-mcp"
]
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblezarcherlot/code-relay is public and reachablegithub.com/zarcherlot/code-relay ↗Aprobado
- El paquete indica este repositorio como su origencode-relay-mcp names zarcherlot/code-relay as sourcenpmjs.com/package/code-relay-mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-01github.com/zarcherlot/code-relay ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from code-relay-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre Code Relay MCP
¿Cómo agrego Code Relay MCP a Claude Code?
Ejecuta claude mcp add code-relay -- npx -y code-relay-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Code Relay MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué agentes de programación son compatibles con Code Relay?
Funciona con Codex, Claude Code, Cursor, VS Code y otros agentes de programación con capacidad MCP.
¿Cuál es el propósito del Target Host en el flujo de trabajo de Relay?
El Target Host actúa como el Checkpoint, verificando el commit exacto de la fuente en su entorno real y devolviendo un Receipt que registra el resultado.