@textbee/mcp

textbee.dev용 MCP 서버입니다. textbee.dev는 Android 휴대폰을 SMS API로 바꿔주는 오픈소스 SMS 게이트웨이입니다. Claude Desktop, Claude Code, Cursor 및 모든 MCP 클라이언트가 자신의 휴대폰과 자신의 번호를 통해 SMS를 보내고 읽을 수 있게 해줍니다.

세 가지 도구, 메시지별 마크업 없음, 자체 호스팅 textbee 인스턴스에서도 작동합니다.

설정

페어링된 Android 기기와 대시보드에서 받은 API 키가 있는 textbee 계정이 필요합니다. 키는 계정에 대한 전체 액세스 권한을 가지므로 비밀번호처럼 취급하세요.

Claude Code

claude mcp add textbee -s user -e TEXTBEE_API_KEY=your-key -- npx -y @textbee/mcp

Claude Desktop

claude_desktop_config.json에 추가하세요 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "textbee": {
      "command": "npx",
      "args": ["-y", "@textbee/mcp"],
      "env": { "TEXTBEE_API_KEY": "your-key" }
    }
  }
}

Cursor

~/.cursor/mcp.json에 동일한 객체를 넣으세요.

첫 시작이 느린 경우

npx는 첫 실행 시 패키지를 다운로드합니다. 클라이언트가 대기 중 시간 초과되면 한 번 전역으로 설치하고 구성에서 바이너리를 가리키세요:

npm install -g @textbee/mcp

{ "mcpServers": { "textbee": { "command": "textbee-mcp", "env": { "TEXTBEE_API_KEY": "your-key" } } } }

Related MCP server: commune-mcp

도구

send_sms

하나 이상의 수신자에게 SMS를 보냅니다 (E.164 형식, 예: +15550100123). 발신 전화는 자동으로 선택됩니다: 기본 기기, 그렇지 않으면 가장 최근 하트비트가 있는 활성 기기. 선택적 device_id, sim_subscription_id, scheduled_at가 있습니다. 계정이 SMS 큐를 사용할 때 배송 확인을 위한 sms_batch_id를 반환합니다.

get_messages

계정의 모든 기기에서 메시지를 읽습니다. 기본값은 수신 메시지, 최신순입니다. direction (received, sent, all), 자유 텍스트 search, sms_batch_id (보내기의 수신자별 배송 상태), device_ids, from/to 시간 창으로 필터링합니다. 중복이나 누락 없이 폴링할 수 있는 커서 페이지네이션을 지원합니다.

list_devices

계정의 휴대폰: ID, 활성 상태, 기본 발신 기기, 마지막 체크인, 메시지 수.

자체 호스팅 textbee

서버를 자신의 인스턴스로 지정하세요:

"env": {
  "TEXTBEE_API_KEY": "your-key",
  "TEXTBEE_BASE_URL": "https://sms.example.com"
}

/api/v1 접미사는 선택 사항이며 자동으로 추가됩니다. https://example.com/textbee 같은 하위 경로 배포도 작동합니다. 잘못된 URL은 조용한 폴백 대신 오류를 발생시키므로 오타가 있어도 키가 공개 API로 전송되지 않습니다.

환경 변수

참고 사항

• 키는 사용자 머신에 유지됩니다: 이 서버는 위의 기본 URL에서 textbee API와만 통신합니다.

• 전송은 textbee 요금제 할당량에 포함되며, 요금제의 속도 제한이 서버 측에 적용됩니다.

• 모든 진단은 stderr로 전송됩니다. stdout은 MCP 프로토콜 전용입니다.

라이브러리로 사용하기

패키지는 다른 MCP 호스트에 포함할 수 있도록 도구 정의도 내보냅니다 (호스팅된 원격 엔드포인트가 이를 재사용하는 방식입니다):

import { createTextbeeMcpServer, staticCredentials, loadConfig } from '@textbee/mcp'

const server = createTextbeeMcpServer({
  credentials: staticCredentials(loadConfig(process.env)),
})

자격 증명은 각 도구 호출 시 해석되므로, 다중 테넌트 호스트는 요청별로 다른 키를 주입할 수 있습니다. credentialsFromAuthInfoExtra를 참조하세요.

라이선스

MIT. textbee 프로젝트의 일부입니다.