MCP Relay

🚀 Relay

Relay 是一款極其簡單的工具，它能在 Claude Desktop 和 Claude Code 之間傳遞信息，包括文件、代碼、數據、註釋、說明等，同時保持它們的主上下文窗口相互獨立。

Claude Desktop 和 Claude Code 都能自主發送消息，當一方需要另一方的輸入時，會自動發送。當有消息到達時，你會收到系統通知，待準備好後即可獲取。

為何需要它？ Desktop 和 Code 各有優勢。Desktop 更適合進行對話，如規劃、頭腦風暴、審核和完善文本；Code 則更擅長執行任務，如編輯文件、運行命令和處理錯誤。但它們之間無法共享上下文。如果你在 Desktop 中起草了內容，想讓 Code 來實現，或者想聽取 Desktop 對正在編寫的代碼的意見，就不得不手動在兩個應用程序之間複製粘貼。

Relay 能在無需你手動指定問題和在窗口間複製粘貼的情況下，將它們連接起來。這本應是 Anthropic 集成的基本功能。

你能完全掌控：獲取消息通常是用戶的主動操作，你可以輸入 get 或 /get。模型在需要另一方的輸入時可以自主發送或獲取消息，但不會進行自動的後臺同步，避免出現無節制的大語言模型間對話消耗你的令牌。

🚀 快速開始

以下是一個快速示例，展示瞭如何使用 Relay 在 Claude Desktop 和 Claude Code 之間傳遞信息：

[在 Desktop 中]
你:     將我上一條錯誤消息發送到 Code。
Desktop: [通過中繼發送]

[Code 的終端中彈出通知]

[在 Code 中]
你:     /get
Code:    已獲取。錯誤來自 parser.py 文件的第 47 行，正則表達式不匹配。
         [修復了該錯誤]

✨ 主要特性

• 信息傳遞：能在 Claude Desktop 和 Claude Code 之間輕鬆傳遞各類信息，如文件、代碼、數據等。
• 自主消息發送：兩個 Claude 工具都能自主發送消息，當需要另一方輸入時自動執行。
• 系統通知：有新消息到達時，會及時推送系統通知，方便用戶及時獲取消息。
• 用戶掌控：獲取消息主要由用戶手動操作，避免自動同步帶來的問題。
• 獨立使用：Desktop 和 Code 仍可獨立使用，Relay 僅在需要時進行連接。

📦 安裝指南

前提條件

什麼是 uvx？ uvx 可以直接運行 Python 包，而無需全局安裝。它會自動處理依賴項。如果你還沒有安裝 uvx，可以運行以下命令進行安裝：

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，然後讓它記住以下指令：

記住：當用戶單獨輸入 "get" 或 "/get" 時，使用 relay_fetch 從中繼獲取最近的消息。

你可以通過輸入 "Show me my memory edits." 來驗證該指令是否已被記錄。

2. 配置 Claude Code

在項目根目錄的 .mcp.json 文件中添加以下內容：

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

注意：只有 Desktop 需要 --sound 參數，因為它負責處理雙方的通知。

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 替換為你實際克隆的倉庫路徑。

💻 使用示例

基礎用法

[在 Code 中]
你:     我的分類器準確率一直停留在 72%。將訓練配置和上一輪的指標發送到 Desktop。
Code:    [通過中繼發送 config.yaml 和指標]

[系統通知顯示消息已發送到 Desktop]

[在 Desktop 中]
你:     /get
Desktop: [獲取配置和指標]
         損失曲線表明你可能存在欠擬合問題。對於這個規模的模型，學習率 1e-5 過於保守...

你:     你會嘗試什麼方法？
Desktop: 將學習率提高到 3e-5，增加預熱步驟，並且你的批量大小為 8，有點小。如果內存允許，嘗試使用 16。此外，類別不平衡問題很嚴重，比例為 80/15/5。考慮使用加權損失或對少數類別進行過採樣。

你:     指定具體更改。
Desktop: [通過中繼發送更新後的配置]

[系統通知顯示消息已發送到 Code]

[在 Code 中]
你:     /get
Code:    已獲取。正在更新 config.yaml 並在損失函數中添加類別權重。
         [編輯文件，開始訓練]

         第 12 輪：準確率提高到 79%，但類別 2 的精度下降了。想聽聽 Desktop 的看法嗎？

你:     是的，發送混淆矩陣。
Code:    [通過中繼發送]

[在 Desktop 中]
你:     /get
Desktop: 類別 2 與類別 0 容易混淆，它們在語義上可能很接近。我需要更多示例。
         [通過中繼自動向 Code 發送請求]

高級用法

• 命令變體：
  • /get — 從 Desktop 獲取並執行消息
  • /get status — 顯示消息數量和最後活動時間
  • /get clear — 清除緩衝區中的所有消息
  • /get <message> — 向 Desktop 發送消息
• 資源訪問：你還可以使用 @relay:messages://latest 直接引用消息。這比 /get 更快，並且在計劃模式下也能使用。
• 啟動預覽：當 Code 啟動時，你會看到來自 Desktop 的任何待處理消息的預覽。使用 /get 可以完整讀取這些消息。

發送消息非常簡單且隱式。當你說 "Ask Desktop if this looks right" 或 "Send the README to Code" 時，模型會識別意圖並自動調用中繼。

📚 詳細文檔

通知設置

當有消息到達時，你會收到系統通知，無需手動輪詢。不同平臺的通知方法如下：

聲音設置：添加 --sound 參數可啟用通知聲音。如果不指定值，則使用平臺默認聲音；如果指定值，則使用指定的聲音：

通知的持續時間和顯示行為由你的操作系統設置控制。

工具說明

🔧 技術細節

• 緩衝區：使用 SQLite 數據庫，存儲在 ~/.relay_buffer.db。
• 滾動窗口：最多存儲 20 條消息，舊消息先被移除。
• 消息限制：每條消息最大為 64 KB。
• 空閒超時：1 小時，服務器在無活動時會自動退出。
• 傳輸方式：使用標準輸入輸出（標準 MCP）。
• Python 版本：需要 Python 3.9 及以上版本。

📄 許可證

文檔中未提及相關信息，故跳過該章節。

作者

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