シグナルMCP
AI エージェントが Signal メッセージを送受信できるようにする、 signal-cliのMCP統合。
特徴
- Signalユーザーにメッセージを送信する
- Signalグループにメッセージを送信する
- 受信メッセージを受信して解析する
- タイムアウト処理による非同期サポート
- 詳細なログ記録
前提条件
このプロジェクトでは、signal-cli をシステムにインストールして設定する必要があります。
signal-cliのインストール
- signal-cli をインストールします。公式のインストール手順に従ってください。
- Signalアカウントを登録します:
signal-cli -u YOUR_PHONE_NUMBER register
- SMS 経由で受信したコードを使用してアカウントを確認します。
signal-cli -u YOUR_PHONE_NUMBER verify CODE_RECEIVED
より詳細なセットアップ手順については、 signal-cli のドキュメントを参照してください。
インストール
pip install -e .
# or use uv for faster installation
uv pip install -e .
使用法
MCP サーバーを実行します。
./main.py --user-id YOUR_PHONE_NUMBER [--transport {sse|stdio}]
API
利用可能なツール
send_message_to_user
: Signal ユーザーにダイレクトメッセージを送信するsend_message_to_group
: Signalグループにメッセージを送信するreceive_message
: タイムアウトをサポートしたメッセージを待機および受信します
発達
このプロジェクトでは以下を使用します:
- エージェントAPI統合のためのMCP
- 現代のPythonの非同期パターン
- 全体にタイプ注釈