Phone A Friend MCP

🚀 電話求助MCP（Phone - a - Friend MCP）

電話求助MCP是一個MCP服務器，它能夠讓Claude Code實例進行即時通信。一個實例進入“監聽模式”，而另一個實例則帶著特定意圖發起聯繫。

🚀 快速開始

本項目可讓Claude Code實例實現即時通信，按照以下步驟操作即可使用。

🏗️ 架構

┌─────────────────────────────────────────┐
│      paf - hub (TCP服務器)               │
│      本地地址:7777                     │
└─────────────────────────────────────────┘
         ▲                    ▲
         │ TCP                │ TCP
         │                    │
   Claude標籤1          Claude標籤2
   (監聽方)            (呼叫方)

📦 安裝指南

在終端中執行以下命令進行安裝：

cd ~/.claude/mcps/phone - a - friend
pip install -e .

💻 使用示例

基礎用法

按照以下步驟使用本服務：

步驟1：啟動中心服務

paf - hub

步驟2：配置Claude Code

在~/.claude/settings.json文件中添加以下內容：

{
  "mcpServers": {
    "phone - a - friend": {
      "command": "python",
      "args": ["-m", "phone_a_friend.server"],
      "cwd": "/Users/YOUR_USERNAME/.claude/mcps/phone - a - friend/src"
    }
  }
}

步驟3：開始使用

標籤1（監聽方）：

"監聽問題。你是認證專家。"

→ paf(action="listen", session_name="auth - expert", description="認證專家") → 進入阻塞等待狀態...

標籤2（呼叫方）：

"向認證專家詢問令牌刷新的問題。"

→ paf(action="list_sessions") → 看到 "auth - expert" → paf(action="connect", target_session="auth - expert", intent="令牌刷新", my_name="feature - dev") → paf(action="send", target_session="auth - expert", message="如何處理過期令牌?", my_name="feature - dev") → paf(action="wait_response", my_name="feature - dev") → 進入阻塞等待回覆狀態

標籤1收到消息並回復： → 監聽方接收到問題後解除阻塞 → paf(action="respond", session_name="auth - expert", message="使用滑動窗口...") → paf(action="listen", ...) → 回到等待狀態

高級用法

本項目提供了完整的對話流程，以下是詳細的交互過程：

監聽方                              呼叫方
────────                              ──────
listen() [進入阻塞狀態]
                                      connect(intent)
                                      send(問題)
[接收到問題]
respond(答案)
                                      wait_response() → 答案
listen() [進入阻塞狀態]                     send(後續問題)
[接收到後續問題]
...

📚 詳細文檔

工具參考

單工具paf支持以下操作：