Buttplug MCP: LLM 기반 성인용 디바이스 제어 프로젝트 요약

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

LLM 개발자, MCP 프로토콜 구현자, 성인용 디바이스 제어 시스템 설계자

• 난이도: 중급 이상 (LLM/WS 기반 통신 경험 필요)*

핵심 요약

• LLM-기반 MCP 서버로, Buttplug.io 디바이스와 WebSocket 12345 포트 통신 지원
• /device/{id}/vibrate API는 id, strength 필수 파라미터로 진동 제어 가능
• go-butplug 라이브러리 불안정성으로 인해 현재 기능 완성도 60% 이하 상태

섹션별 세부 요약

1. 프로젝트 개요

• MCP 서버는 Buttplug.io 디바이스 제어를 위한 LLM-기반 중개 서버
• Claude Desktop 등 LLM 툴에서 "LELO F1S 두 번째 모터 50%" 형식의 자연어 명령 가능
• MIT 라이선스로 공개, GitHub Releases에서 다중 플랫폼 바이너리 배포

2. API 및 툴

• /devices 엔드포인트: 연결된 디바이스 목록(JSON) 제공
• device_vibrate 툴: id, strength 파라미터로 진동 제어
• RSSI/배터리 조회 API는 /device/{id}/rssi, /device/{id}/battery 제공

3. 설정 및 제한 사항

• Homebrew 설치: brew install conacademy/tap/buttplug-mcp
• Intiface Central 앱에서 디바이스 관리(포트 12345)
• Ollama 등 MCP 호스트와 연동 가능하지만 "Resources" 기능 제한

4. 개발 현황 및 향후 계획

• 2025년 4월 시작한 실험 프로젝트로 엔드투엔드 테스트 미비
• go-butplug 라이브러리 개선 및 MCP 프로토콜 호스트 확장 예정
• Task 기반 빌드 시스템 지원: $ task stdio-schema | jq 등 테스트 도구 활용

결론

• MCP 서버는 LLM-디바이스 연동 실험용으로, 실무 적용 시 go-butplug 라이브러리 안정화 필요
• "device_vibrate" API가 핵심 기능이지만, 현재 30% 이하의 실제 디바이스 반응률 보고됨
• HomeAssistant 연동을 통해 조명 제어 등 다양한 IoT 확장 가능성 있음