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：等待接收带超时支持的消息