신호 MCP
AI 에이전트가 Signal 메시지를 보내고 받을 수 있도록 하는 signal-cli 에 대한 MCP 통합입니다.
특징
- Signal 사용자에게 메시지 보내기
- Signal 그룹에 메시지 보내기
- 수신 메시지 수신 및 구문 분석
- 시간 초과 처리를 통한 비동기 지원
- 자세한 로깅
필수 조건
이 프로젝트를 실행하려면 시스템에 signal-cli를 설치하고 구성해야 합니다.
signal-cli 설치
- signal-cli 설치 : 공식 설치 지침을 따르세요
- Signal 계정을 등록하세요 :지엑스피1
- 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 비동기 패턴
- 전체에 유형 주석이 있습니다.