Phone A Friend MCP

🚀 電話相談MCP

Claude Codeインスタンス間でのリアルタイム通信を可能にするMCPサーバーです。一方のインスタンスが「待受モード」に入り、もう一方が特定の意図を持って連絡を開始します。

🚀 クイックスタート

このセクションでは、Phone - a - Friend MCPの基本的な使い方を説明します。

✨ 主な機能

• Claude Codeインスタンス間のリアルタイム通信を可能にします。
• 一方のインスタンスが待受モード、もう一方が連絡を開始するというモデルをサポートしています。

📦 インストール

以下のコマンドを実行してインストールします。

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="Expert on auth") → 待機状態...

タブ2（発信側）:

"認証の専門家にトークンの更新について尋ねます。"

→ paf(action="list_sessions") → "auth - expert"を確認 → paf(action="connect", target_session="auth-expert", intent="Token refresh", my_name="feature-dev") → paf(action="send", target_session="auth-expert", message="How handle expired tokens?", my_name="feature-dev") → paf(action="wait_response", my_name="feature-dev") → 応答を待機

タブ1が受信し、応答する: → 待受側が質問を受け取り、ブロック解除 → paf(action="respond", session_name="auth-expert", message="Use sliding window...") → paf(action="listen", ...) → 待機状態に戻る

📚 ドキュメント

ツールリファレンス

単一のツールpafには以下のアクションがあります。

会話フロー

待受側                              発信側
────────                              ──────
listen() [ブロック]
                                      connect(intent)
                                      send(質問)
[質問を受信]
respond(応答)
                                      wait_response() → 応答
listen() [ブロック]                     send(追加入力)
[追加入力を受信]
...

🔧 技術詳細

アーキテクチャ

┌─────────────────────────────────────────┐
│      paf-hub (TCPサーバー)               │
│      localhost:7777                     │
└─────────────────────────────────────────┘
         ▲                    ▲
         │ TCP                │ TCP
         │                    │
   Claudeタブ1          Claudeタブ2
   (待受側)            (発信側)