Signal

🚀 信號 MCP 集成

本項目是專為 signal-cli 打造的 MCP 整合方案，可讓 AI 代理實現 Signal 消息的收發功能，為消息交互提供了便捷途徑。

🚀 快速開始

此項目需要 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 .
# 或使用 uv 加快安裝
uv pip install -e .

運行 MCP 服務器

./main.py --user-id YOUR_PHONE_NUMBER [--transport {sse|stdio}]

✨ 主要特性

• 向 Signal 用戶發送消息
• 向 Signal 群組發送消息
• 接收並解析 incoming 消息
• 異步支持及超時處理
• 詳細日誌記錄

📦 安裝指南

pip install -e .
# 或使用 uv 加快安裝
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：等待接收帶超時支持的消息