シグナルMCP

AI エージェントが Signal メッセージを送受信できるようにする、 signal-cliのMCP統合。

特徴

• Signalユーザーにメッセージを送信する

• Signalグループにメッセージを送信する

• 受信メッセージを受信して解析する

• タイムアウト処理による非同期サポート

• 詳細なログ記録

Related MCP server: Interactive Feedback MCP

前提条件

このプロジェクトでは、signal-cli をシステムにインストールして設定する必要があります。

signal-cliのインストール

1. signal-cli をインストールします。公式のインストール手順に従ってください。

2. Signalアカウントを登録します:

   signal-cli -u YOUR_PHONE_NUMBER register

3. 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の非同期パターン

• 全体にタイプ注釈