Twilio 메시징 MCP 서버

Twilio API를 통해 SMS 메시지를 보낼 수 있는 MCP(Model Context Protocol) 서버입니다.

특징

• Twilio를 통해 SMS 메시지 보내기

• Claude Desktop과 같은 MCP 클라이언트와 통합됩니다.

• 환경 변수 없이 보안 자격 증명 처리

• 보안 강화를 위해 Twilio API 키를 사용합니다.

Related MCP server: Twilio MCP Server

설치

npx를 통해 이 서버를 직접 사용할 수 있습니다.

지엑스피1

또는 전역적으로 설치하세요.

npm install -g twilio-messaging-mcp-server
twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

구성

서버에는 다음과 같은 매개변수가 필요합니다.

• accountSid : Twilio 계정 SID(AC로 시작해야 하며, 검증됨)

• apiKey : Twilio API 키(SK로 시작)

• apiSecret : Twilio API 비밀번호

• number : 메시지를 보낼 Twilio 전화번호(E.164 형식, 예: +1234567890)

보안 참고 사항

이 서버는 보안 강화를 위해 인증 토큰 대신 API 키와 비밀번호를 사용합니다. 이러한 접근 방식은 더 나은 액세스 제어 기능을 제공하고 필요한 경우 사용자 인증 정보를 취소할 수 있도록 합니다. 자세한 내용은 Twilio API 키 문서를 참조하세요.

Claude Desktop과 함께 사용

지역 개발

로컬 개발의 경우(패키지가 npm에 게시되지 않은 경우), Claude Desktop 구성 파일(macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json , Windows에서는 %APPDATA%\Claude\claude_desktop_config.json )에 다음을 추가합니다.

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

값을 실제 Twilio 자격 증명으로 바꾸세요.

• 첫 번째 인수: Twilio 계정 SID(AC로 시작)

• 두 번째 인수: Twilio API 키("SK"로 시작)

• 세 번째 인수: Twilio API 비밀번호

• 네 번째 인수: E.164 형식의 Twilio 전화번호

프로젝트 디렉토리에서 다음 명령을 실행하면 절대 경로를 얻을 수 있습니다.

# On macOS/Linux
echo "$(pwd)/build/index.js"

# On Windows (PowerShell)
Write-Output "$((Get-Location).Path)\build\index.js"

npm에 게시한 후

패키지가 npm에 게시되면 다음 구성을 사용할 수 있습니다.

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "npx",
      "args": [
        "-y", 
        "twilio-messaging-mcp-server",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

사용 가능한 도구

문자 보내기

Twilio를 통해 SMS 메시지를 보냅니다.

매개변수:

• to : E.164 형식의 목적지 전화번호(예: +1234567890)

• message : 보낼 메시지 내용

Claude에서의 사용 예:

Can you send an SMS to +1234567890 saying "Hello from MCP!"

개발

프로젝트를 빌드하려면:

npm install
npm run build

수동으로 서버 실행

테스트를 위해 서버를 수동으로 시작하려면(Claude Desktop 외부):

# Run with actual credentials
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

# Or use the npm script (which uses ts-node for development)
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

서버가 시작되고 MCP 클라이언트 연결을 기다립니다. 다음과 같은 출력이 표시됩니다.

[TwilioMessagingServer] Server started successfully

Claude Desktop과 함께 사용하는 경우, Claude가 구성 파일을 로드하면 서버가 자동으로 시작됩니다. 수동으로 시작할 필요가 없습니다.

특허

MIT