faxdrop-mcp은(는) 무엇을 하나요?
MCP를 지원하는 모든 AI 어시스턴트에서 실제 팩스를 전송할 수 있습니다. FaxDrop API(PDF/DOCX/JPG/PNG, 국제 번호, 상태 폴링)를 래핑하며, 속도 제한, 드라이런 모드, 감사 로깅을 제공합니다.
기능
- 팩스 전송: PDF, DOCX, JPG, PNG 파일을 팩스로 전송합니다.
- 국제 번호 지원: 전 세계 전화번호로 전송 가능합니다.
- 상태 폴링: 전송 상태를 주기적으로 확인하여 최종 결과를 제공합니다.
- 속도 제한: 요청 속도를 제한하여 API 남용을 방지합니다.
- 드라이런 모드: 실제 전송 없이 테스트를 수행할 수 있습니다.
- 감사 로깅: 모든 전송 내역을 기록합니다.
설치
# MCP 설정에 추가 (예: Claude Code의 경우)
mcp install klodr/faxdrop-mcp
설정
다음 환경 변수를 설정해야 합니다:
FAXDROP_API_KEY: FaxDrop API 키
선택적 환경 변수:
FAXDROP_DRY_RUN:true로 설정하면 드라이런 모드가 활성화됩니다.FAXDROP_RATE_LIMIT: 초당 최대 요청 수 (기본값: 5)FAXDROP_AUDIT_LOG: 감사 로그 파일 경로 (기본값:faxdrop-audit.log)
사용 예시
AI 어시스턴트에게 팩스 전송 요청
'1234567890' 번호로 'document.pdf'를 팩스로 보내줘.
지원되는 파일 형식
- DOCX
- JPG
- PNG
드라이런 모드
드라이런 모드로 'test.pdf'를 '1234567890'으로 보내줘. (실제 전송하지 않음)
API 참조
전송 요청
{
"to": "+1234567890",
"file": "base64-encoded-file-content",
"filename": "document.pdf"
}
응답
{
"success": true,
"faxId": "fax_abc123",
"status": "queued"
}
라이선스
MIT