remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides sending SMS messages and making Text-to-Speech calls via ClickSend's API, with features for phone number validation and rate limiting.

ClickSend MCP 서버

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

특징

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

설치

필수 조건

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

설정

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

MCP 클라이언트 설정

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

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

{
    "mcpServers": {
        "clicksend": {
            "command": "node",
            "args": ["/directory/to/build/folder/clicksend-mcp/build/index.js"],
            "env": {
                "CLICKSEND_USERNAME": "example@droove.net",
                "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX"
            }
        }
    }
}

용법

사용 가능한 도구

1. 문자 보내기

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

매개변수:

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

예:

{
  "name": "send_sms",
  "arguments": {
    "to": "+61423456789",
    "message": "Hello from ClickSend MCP!"
  }
}

2. make_tts_call

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

매개변수:

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

예:

{
  "name": "make_tts_call",
  "arguments": {
    "to": "+61423456789",
    "message": "This is a Text-to-Speech call from ClickSend MCP",
    "voice": "female"
  }
}

속도 제한

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

개발

사용 가능한 스크립트

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

프로젝트 구조

clicksend-mcp/
├── src/
│   ├── index.ts        # Main server implementation
│   ├── client.ts       # ClickSend API client
│   └── utils/
│       └── validation.ts # Input validation utilities
├── build/              # Compiled JavaScript output
└── package.json        # Project configuration

오류 처리

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

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

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

할 일

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

특허

MIT

기여하다

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

이 서버를 사용하면 AI 모델이 ClickSend의 API를 사용하여 SMS 메시지를 보내고 텍스트-음성 통화를 프로그래밍 방식으로 시작할 수 있으며, 여기에는 속도 제한 및 입력 검증 기능이 내장되어 있습니다.

Related Resources

Reddit Discussion about this server

ClickSend MCP Server