Code Relay

ローカル

github.com開発ツール08 週間前に更新

リポジトリ公式サイト

Code Relay について

Code Relayは、開発と検証を別々のマシンで行うコーディングエージェント向けMCP連携です。ブランチとソースコミットにランブックを紐付け、修正作業に使える構造化レシートを返します。

主な機能

01ブランチ単位のプロジェクト紐付け
02分離したワークツリーでのコミット検証
03セルフホストランナーでのチェックポイント実行
04制限付き許可コマンドの実行
05検証結果の構造化レシート

活用シーン

01Linuxや本番に近い環境でのコード検証
02CUDA/GPUマシンでのモデルコード実行
03ローカルで利用できない連携やデバイスのテスト

MCP 対応

Code Relayはstdioで通信するローカルMCPサーバーです。プロジェクト紐付け、チェックポイント管理、ランブック公開、状態確認、レシート取得、分析のツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "zarcherlot-code-relay": {
      "command": "npx",
      "args": [
        "-y",
        "code-relay-mcp"
      ]
    }
  }
}

起動コマンドnpx -y code-relay-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmcode-relay-mcp3.1.0stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Code Relay

英語 · 中国語

開発する。検証する。中継する。

Code Relay を使うと、コーディングエージェントがあるマシンで開発し、別のマシンで結果を検証できます。

Relay は、マシンをまたいだ開発と検証を実現する、MCP ベースのコーディングエージェント連携機能です。Dev Host 上の AI が依頼を実装し、Target Host が実際の検証を実行します。構造化されたレシートが返され、次の修正サイクルに役立てられます。Codex、Claude Code、Cursor、VS Code など、MCP に対応したコーディングエージェントで利用できます。

Relay が役立つ場面

異なる環境 — Windows や macOS で開発し、Linux、プライベートネットワーク、または本番に近いホストで検証できます。
特殊なハードウェア — モデルのコードを CUDA/GPU マシンに送り、カメラ、シリアルデバイス、センサーなど、接続先の環境で検証できます。
実際の連携機能 — ローカルでは再現できない決済コールバック、キュー、データベース、ブラウザー、内部サービスをテストできます。
AI による反復 — 具体的な期待値と実測値を返すことで、コーディングエージェントが修正、再公開、再試行できるようにします。

Relay が提供する機能

ブランチ単位のプロジェクトバインドと、有効期間の短い参加リンク。
分離されたワークツリーでの正確なソースコミット検証。
code-relay-checkpoint GitHub Actions セルフホストランナーを通じたチェックポイント実行。
出力とタイムアウトに上限を設けた、安全な許可リスト方式の検証コマンド。
成功、失敗、ブロックされた実行についての、構造化された receipt.json と人間が読めるレシート。

クイックスタート

AI クライアントのインストール

コーディングエージェントに手順を読み、従うよう指示してください。

https://raw.githubusercontent.com/zarcherlot/code-relay/main/install.md

npm を使った代替手段

npx -y code-relay-mcp@latest install --client codex

必要に応じて、codex を claude-code、cursor、vscode、または generic に置き換えてください。

MCP サーバーの詳細

Code Relay は、stdio 経由で通信するローカル MCP サーバーです。npm パッケージは、次のコマンドでサーバーを起動します。

npx -y [email protected]

サーバーは、サードパーティの MCP SDK を使わず、Go で MCP JSON-RPC のインターフェースを直接実装しています。initialize、ping、tools/list、tools/call をサポートし、次のツールを提供します。

ツール	用途
`bind_project`	リポジトリとブランチをリレーロールにバインドします。
`create_checkpoint_invite`	有効期間の短いチェックポイント参加リンクを作成します。
`join_checkpoint`	ブランチ単位のチェックポイントサブスクリプションに参加します。
`watcher_status`	ローカルウォッチャーの状態を読み取ります。
`stop_watcher`	ローカルウォッチャーを停止します。
`doctor`	ローカルの状態を変更せずにヘルスチェックを実行します。
`publish_runbook`	ランブックを検証して公開します。
`status`	ランブックとレシートの状態を読み取ります。
`fetch_receipt`	ランブックのレシートを読み込み、検証します。
`analyze`	レシートを分析し、次の状態を判断します。

実装とトランスポートループは internal/relay/mcp.go にあります。

動作の仕組み

Dev Host が Code Relay を通じて Target Host にランブックを送信し、Target Host がチェックポイントを実行して、エビデンスを含むレシートを返します

Dev Host は Relay を通じて、リポジトリとブランチに紐づいたランブックを送信します。Target Host は実際の環境で正確なソースコミットをチェックし、チェックポイントの結果を記録したレシートを返します。

すべてのランブックは、リポジトリ、ブランチ、ソースコミットに紐づいています。Target Host はチェックポイントとして動作し、生成されたレシートには、次の反復に向けて検証の成功、失敗、またはブロックが記録されます。

ドキュメント

ライセンス

Code Relay は MIT ライセンスのもとで公開されています。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Code Relay

Code Relay について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Code Relay

開発する。検証する。中継する。

Relay が役立つ場面

Relay が提供する機能

クイックスタート

AI クライアントのインストール

npm を使った代替手段

MCP サーバーの詳細

動作の仕組み

ドキュメント

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？