MCP Relay

🚀 Relay

Relayは、Claude DesktopとClaude Codeのメインコンテキストウィンドウを分離したまま、ファイル、コード、データ、コメント、指示などの情報をやり取りする、非常にシンプルなツールです。

両方のClaudeは自律的にメッセージを送信できます。相手側からの入力が必要な場合は、自動的に行います。メッセージが届くと、システム通知が表示されます。準備ができたら、メッセージを取得できます。

なぜRelayが必要なのか？ DesktopとCodeにはそれぞれ異なる強みがあります。Desktopは会話、計画立案、アイデア出し、文章のレビューや反復作業に適しています。一方、Codeはファイルの編集、コマンドの実行、エラーの解消などの実行作業に優れています。しかし、これらのアプリ間でコンテキストは共有されません。Desktopで何かを作成し、Codeでそれを実装したい場合や、書いているコードについてDesktopの意見を求めたい場合は、アプリ間でコピー＆ペーストする必要があります。

Relayは、手動で質問を指定したり、ウィンドウ間でコピー＆ペーストしたりすることなく、これらのアプリを接続します。これは、Anthropicによって統合されるべき基本的な機能です。

ユーザーがコントロール可能 メッセージの取得は通常、ユーザーが get または /get を入力することで行われます。モデルは、相手側からの入力が必要と判断した場合に、メッセージを送信または取得できますが、自動的なバックグラウンド同期は行われません。トークンを浪費するようなLLM間の暴走会話も発生しません。

🚀 クイックスタート

💻 使用例

基本的な使用法

[Desktopで]
あなた:     最後のエラーメッセージをCodeに送って。
Desktop:    [Relayを介して送信]

[Codeのターミナルに通知が表示される]

[Codeで]
あなた:     /get
Code:       受け取りました。parser.pyの47行目の問題です。正規表現が一致していません。
            [バグを修正]

高度な使用法

[Codeで]
あなた:     分類器の精度が72%で止まっています。トレーニング設定と最後のエポックのメトリクスをDesktopに送って。
Code:       [config.yamlとメトリクスをRelayを介して送信]

[Desktopにメッセージが送信されたことを示すシステム通知が表示される]

[Desktopで]
あなた:     /get
Desktop:    [設定とメトリクスを取得]
            損失曲線から、アンダーフィッティングしている可能性があります。このサイズのモデルでは、学習率1e-5は保守的です...

あなた:     どのような変更を試すべきですか？
Desktop:    学習率を3e-5に上げ、ウォームアップステップを追加しましょう。また、バッチサイズが8と小さいです。メモリが許せば、16を試してみてください。さらに、クラスの不均衡が激しいです。80/15/5の分割です。重み付き損失または少数クラスのオーバーサンプリングを検討してください。

あなた:     具体的な変更を指定して。
Desktop:    [更新された設定をRelayを介して送信]

[Codeにメッセージが送信されたことを示すシステム通知が表示される]

[Codeで]
あなた:     /get
Code:       受け取りました。config.yamlを更新し、損失関数にクラスの重みを追加します。
            [ファイルを編集し、トレーニングを開始]

            エポック12: 精度が79%まで上がりましたが、クラス2の精度が低下しました。Desktopの意見を聞きますか？

あなた:     はい、混同行列を送って。
Code:       [Relayを介して送信]

[Desktopで]
あなた:     /get
Desktop:    クラス2がクラス0と混同されています。これらは意味的に近い可能性があります。もっと多くの例が必要です。
            [Relayを介してCodeに自動的に要求を送信]

📚 詳細ドキュメント

使い方

Desktopで get またはCodeで /get を入力すると、相手側からのメッセージを確認できます。これが主な操作方法です。

コマンドのバリエーション:

• /get — Desktopからのメッセージを取得して実行
• /get status — メッセージの数と最後のアクティビティを表示
• /get clear — バッファ内のすべてのメッセージを削除
• /get <message> — Desktopにメッセージを送信

リソースへのアクセス: @relay:messages://latest を使用すると、直接メッセージを参照できます。これは /get よりも高速で、計画モードでも動作します。

起動時のプレビュー: Codeを起動すると、Desktopからの保留中のメッセージのプレビューが表示されます。 /get を使用して、メッセージを完全に読むことができます。

メッセージの送信は簡単で暗黙的です。「Desktopにこれが正しいか確認して」や「READMEをCodeに送って」と言うと、モデルが意図を認識し、自動的にRelayを呼び出します。

通知

メッセージが届くと、システム通知が表示されるので、相手側を確認することができます。手動でポーリングする必要はありません。

音声通知: --sound を追加すると、通知音を有効にできます。値を指定しない場合は、プラットフォームのデフォルト設定が使用されます。値を指定すると、指定した音声が使用されます。

通知の表示時間や表示方法は、OSの設定によって制御されます。

設計理念

トランスポート、メモリではない Relayはメッセージバスです。メッセージの要約、圧縮、書き換え、解釈は行いません。共有される隠れたコンテキスト、統合されたシステムプロンプト、またはエージェント間の計画はありません。メッセージは変更されずに通過します。これにより、関心事が明確に分離され、認識論的な腐敗が回避されます。

主にユーザーが制御 メッセージの取得は通常、明示的なユーザーアクション (get または /get) であり、バックグラウンドプロセスではありません。これにより、コンテキストの暴走的な増加やフィードバックループが防止されます。ただし、モデルは、相手側からの入力が必要と判断した場合に、自律的にメッセージを送信または取得することができます。システムはこれを許可しますが、奨励しません。

独立したインターフェース DesktopとCodeはそれぞれ独立して完全に使用可能です。CodeなしでDesktopで長い会話をしたり、DesktopなしでCodeで何時間もデバッグ作業を行ったりすることができます。Relayは、必要なときにこれらを接続しますが、結合しません。これはまた、APIコストがかからないことを意味します。両方のインターフェースは既存のサブスクリプションを使用します。

最小限の表面積 Relayは、送信、取得、クリアの3つのことを行います。オーケストレーション、仲裁、コンセンサス、または自律的な動作を提供しようとはしません。この制約は意図的なものです。ほとんどのマルチエージェント設計は、明確に保たれるべき境界を曖昧にすることで失敗します。

自然にスケール 複数のCodeセッションは同じDesktopに接続できます。メッセージを適切な会話に向けることができます。追加のMCP対応ピア、代替のストレージバックエンド、プロジェクトごとのバッファ、および読み取り専用のオブザーバーはすべて、この設計からきれいに拡張できます。

これは、人間が仲介する、明示的に同期されたマルチエージェントメッセージバスという独特のクラスのインフラストラクチャを定義します。

設計に関する注意事項

Relayはグローバル ~/.relay_buffer.db のバッファは、すべてのプロジェクトで共有されます。Desktopは、現在作業しているプロジェクトを認識していないため、プロジェクトごとの分離は実用的ではありません。これは意図的なものです。一人のユーザー、一台のマシン、一つのRelayです。

Codeでプロジェクトを切り替えると、Relayも一緒に移動します。前のプロジェクトからの古いメッセージがまだ残っている場合があります。新しい開始をする場合は、 /get clear を使用してください。

大きなファイルは遅い 長さが数ページ程度のメッセージに対しては、Relayは高速です。大きなファイルの場合は、直接目的のインターフェースにドラッグ＆ドロップする方が速いです。ただし、関連するコンテキストはRelayを介して送信することができます。

📦 インストール

uvxとは？ uvx は、Pythonパッケージをグローバルにインストールすることなく直接実行できます。依存関係を自動的に処理します。インストールされていない場合は、 curl -LsSf https://astral.sh/uv/install.sh | sh を実行してください（詳細は astral.sh/uv を参照）。

1. Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "relay": {
      "command": "uvx",
      "args": ["mcp-server-relay", "--client", "desktop", "--sound"]
    }
  }
}

Claude Desktopを再起動し、この指示を記憶するように指示します。

Remember: When the user says "get" or "/get" alone, fetch recent messages from the relay using relay_fetch.

「Show me my memory edits.」と言って、記録されたことを確認できます。

2. Claude Codeの設定

プロジェクトルートの .mcp.json に以下を追加します。

{
  "mcpServers": {
    "relay": {
      "command": "uvx",
      "args": ["mcp-server-relay", "--client", "code"]
    }
  }
}

注意: 通知を両方の側で処理するのはDesktopだけなので、 --sound はDesktopでのみ必要です。

3. /get スラッシュコマンドのインストール（オプション）

uvx mcp-server-relay --setup-code

これにより、スラッシュコマンドが ~/.claude/commands/ にコピーされます。

代替方法: GitHubからインストール

uvxを使用したくない場合は、リポジトリをクローンして直接実行します。

git clone https://github.com/mhcoen/mcp-relay.git
cd mcp-relay
python -m venv .venv
.venv/bin/pip install -e .

その後、設定ファイルで完全なパスを使用します。

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "relay": {
      "command": "/path/to/mcp-relay/.venv/bin/python",
      "args": ["/path/to/mcp-relay/relay_server.py", "--client", "desktop", "--sound"]
    }
  }
}

Claude Code (.mcp.json):

{
  "mcpServers": {
    "relay": {
      "command": "/path/to/mcp-relay/.venv/bin/python",
      "args": ["/path/to/mcp-relay/relay_server.py", "--client", "code"]
    }
  }
}

/path/to/mcp-relay を実際のクローン先のパスに置き換えてください。

🛠 ツール

🔧 技術詳細

• バッファ: ~/.relay_buffer.db のSQLite
• ローリングウィンドウ: 最大20メッセージ（最古のメッセージが最初に削除されます）
• メッセージ制限: メッセージごとに最大64 KB
• アイドルタイムアウト: 1時間（非アクティブ状態が続くと、サーバーは自動的に終了します）
• トランスポート: stdio（標準MCP）
• Python: 3.9以上

📄 ライセンス

ライセンス情報は提供されていません。

👤 作者

Michael Coen — mhcoen@alum.mit.edu · mhcoen@gmail.com