ClickSend MCP Server

ClickSend MCP 서버

ClickSend API를 통해 SMS 메시지 전송 및 텍스트 음성 변환(TTS) 통화 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 모델은 SMS 메시지를 전송하고 프로그래밍 방식으로 음성 통화를 시작할 수 있습니다.

특징

• SMS 메시징 : 전 세계 모든 전화번호로 SMS 메시지를 보냅니다.
• 텍스트 음성 변환 통화 : 사용자 정의 가능한 텍스트 음성 변환 메시지로 음성 통화를 하세요
• 속도 제한 : 분당 5개의 작업 제한을 갖춘 내장형 보호 기능
• 입력 검증 : 전화번호 및 메시지 내용에 대한 포괄적인 검증
• 오류 처리 : 자세한 오류 메시지 및 적절한 오류 전파

설치

필수 조건

• Node.js(v16 이상)
• API 자격 증명을 사용한 ClickSend 계정
• MCP 호환 클라이언트

설정

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

MCP 클라이언트 설정

다음 섹션을 cline_mcp_settings.json 파일이나 claude_desktop_config.json 파일�� 추가하세요.

아래 예시에 표시된 대로 디렉토리를 빌드 폴더의 올바른 경로로 바꾸고, 사용자 이름과 API 키도 자신의 것으로 바꾸세요.

용법

사용 가능한 도구

1. 문자 보내기

지정된 전화번호로 SMS 메시지를 보냅니다.

매개변수:

• to : E.164 형식의 전화번호(예: +61423456789)
• message : 보낼 텍스트 내용

예:

2. make_tts_call

텍스트-음성 통화를 시작합니다.

매개변수:

• to : E.164 형식의 전화번호
• message : 음성으로 변환할 텍스트 콘텐츠
• voice : 음성 유형('여성' 또는 '남성', 기본값은 '여성')

예:

속도 제한

서버는 남용을 방지하기 위해 분당 5개의 작업으로 속도 제한을 적용합니다. 이 제한을 초과하는 요청은 재시도 지연 제안과 함께 오류 응답을 받게 됩니다.

개발

사용 가능한 스크립트

• npm run build : TypeScript를 컴파일하고 출력을 실행 가능하게 만듭니다.
• npm run start : MCP 서버 시작
• npm run dev : 감시 모드에서 TypeScript 컴파일러 실행

프로젝트 구조

오류 처리

서버는 다양한 시나리오에 대한 자세한 오류 메시지를 제공합니다.

• 잘못된 전화번호
• 메시지 내용 검증 실패
• 요금 제한을 초과했습니다
• API 인증 오류
• 네트워크 연결 문제

오류 응답에는 문제를 진단하는 데 도움이 되는 적절한 오류 코드와 설명 메시지가 포함됩니다.

할 일

• [ ] 여러 수신자
• [ ] 발신자 ID 구성
• [x] 문자
• [x] TTS
• [ ] 이메일
• [ ] 미디어 업로드
  • [ ] 이메일 첨부 파일
  • [ ] 엠에스엠에스
  • [ ] 편지
  • [ ] 엽서
  • [ ] 팩스
• [ ] 비용 계산 및 확인
• [ ] 통계
• [ ] 역사
• [ ] 연락처
• [ ] 자동화

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.