ClickSend MCP 서버

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

특징

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

Related MCP server: Slack MCP Server

설치

필수 조건

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