構造化されたrunbookとreceiptを通じて、コーディングエージェントが1台のマシンで開発を行い、別のターゲットホストで結果を検証できるようにします。
別名 zarcherlot/code-relay, code-relay, code-relay-mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 3.1.0
- 最終コミット
- 2026年10月1日
- ライセンス
- MIT
Code Relay MCPとは
構造化されたrunbookとreceiptを通じて、コーディングエージェントが1台のマシンで開発を行い、別のターゲットホストで結果を検証できるようにします。
プロジェクトのREADMEから生成された概要
Code Relay MCP server について
異なるハードウェアやネットワーク環境で作業内容を検証する必要があるコーディングエージェントは、Code Relayを使用して開発と検証のギャップを埋めることができます。開発ホストをターゲットホストに接続することで、AIエージェントは1台のマシンでコードを書き、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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Code Relayと互換性のあるコーディングエージェントは何ですか?
Codex、Claude Code、Cursor、VS Code、およびその他のMCP対応のコーディングエージェントで使用できます。
RelayワークフローにおけるTarget Hostの目的は何ですか?
Target HostはCheckpointとして機能し、実際の環境で正確なソースコミットを確認して、結果を記録したReceiptを返します。