Signal MCP

一个用于signal-cli的MCP集成，允许AI代理发送和接收Signal消息。

功能

• 向Signal用户发送消息
• 向Signal群组发送消息
• 接收并解析传入的消息
• 支持异步操作及超时处理
• 详细的日志记录

预备条件

此项目需要在您的系统上安装并配置signal-cli。

安装signal-cli

1. 安装signal-cli：遵循官方安装说明

2. 注册您的Signal账户：

   signal-cli -u 您的电话号码 register
   

3. 使用通过短信收到的验证码验证您的账户：

   signal-cli -u 您的电话号码 verify 收到的验证码
   

更多详细的设置说明，请参阅signal-cli文档。

安装

pip install -e .
# 或者使用uv进行更快的安装
uv pip install -e .

使用方法

运行MCP服务器：

./main.py --user-id 您的电话号码 [--transport {sse|stdio}]

API

可用工具

• send_message_to_user：向Signal用户发送直接消息
• send_message_to_group：向Signal群组发送消息
• receive_message：等待并接收带有超时支持的消息

开发

本项目使用：

• MCP进行代理-API集成
• 现代Python异步模式
• 全程类型注解