Name: mcp-buttplug
Author: chiefautism

Claude Code(또는 모든 MCP 클라이언트)를 오픈 소스 친밀 하드웨어 제어 라이브러리인 buttplug.io에 연결하는 MCP 서버입니다. Claude는 실시간으로 햅틱 장치를 검색, 제어 및 조율할 수 있는 도구를 얻게 됩니다.

이제 게임패드 지원이 포함되었습니다. Xbox, PlayStation 및 Switch 컨트롤러가 macOS, Windows 및 Linux에서 진동 장치로 작동합니다. 이는 intiface-engine의 SDL2 포크를 통해 구동됩니다.

LLM이 무엇을, 언제 느낄지 결정합니다.

작동 방식

Claude Code <-> MCP (stdio) <-> buttplug-mcp <-> WebSocket <-> intiface-engine <-> SDL2/BLE/USB <-> Device

buttplug-mcp는 connect를 호출할 때 포크된 intiface-engine을 자동으로 실행합니다. 별도로 설치하거나 실행할 서버가 필요 없습니다. 엔진은 다음을 처리합니다:

게임패드 (Xbox/PS/Switch): SDL2를 통한 크로스 플랫폼 럼블
Bluetooth LE 장난감 (Lovense, We-Vibe 등): btleplug을 통한 연결
USB/직렬 장치: 플랫폼 드라이버를 통한 연결

시작하기

사전 요구 사항

Bun 런타임
Rust 툴체인 (intiface-engine 빌드용)
cmake (SDL2용)

설치

# Install Bun if you don't have it
curl -fsSL https://bun.sh/install | bash

# Install Rust if you don't have it
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install cmake
# macOS: brew install cmake
# Ubuntu: sudo apt install cmake
# Windows: choco install cmake

# Clone and install
git clone https://github.com/chiefautism/buttplug-mcp.git
cd buttplug-mcp
bun install

bun install은 자동으로 buttplug 포크를 복제하고 SDL2 게임패드 지원과 함께 intiface-engine을 빌드합니다. 첫 설치 시 약 2분 정도 소요됩니다.

Claude Code에 추가

~/.claude/.mcp.json 파일을 생성하거나 편집하세요:

{
  "mcpServers": {
    "buttplug": {
      "command": "bun",
      "args": ["/absolute/path/to/buttplug-mcp/index.ts"]
    }
  }
}

실행

Claude Code를 재시작하세요. 도구를 즉시 사용할 수 있습니다.

you: connect and scan for devices

claude: [calls connect] -> [calls scan]
        Connected. Found your Xbox Wireless Controller.

게임패드 설정

블루투스를 통해 컨트롤러를 연결하세요 (USB는 macOS에서 럼블을 지원하지 않으므로 사용하지 마세요):

Xbox/PS 버튼을 깜빡일 때까지 길게 누릅니다.
페어링 버튼을 누릅니다 (Xbox의 경우 USB 포트 근처의 작은 버튼).
시스템 설정 → 블루투스 → 연결로 이동합니다.
Claude Code에서: connect → scan → 컨트롤러가 나타납니다.

도구

도구	설명
`connect`	Intiface Engine에 연결 (필요 시 자동 실행)
`scan`	장치 검색 (게임패드, 블루투스, USB)
`devices`	연결된 장치 목록 표시
`vibrate`	강도 `0.0`-`1.0`으로 진동, 선택적 자동 정지 타이머
`rotate`	속도 `0.0`-`1.0`으로 회전
`oscillate`	강도 `0.0`-`1.0`으로 진동(오실레이트)
`linear`	지속 시간 동안 위치로 이동 (스트로커 장치)
`pulse`	패턴화된 펄스 — 횟수, 켜짐/꺼짐 타이밍, 강도
`wave`	시간 경과에 따라 두 강도 사이를 부드럽게 전환
`stop`	하나 또는 모든 장치 정지
`battery`	장치 배터리 잔량 확인
`disconnect`	연결 해제 및 엔진 정지

사용법

연결되면 Claude와 대화하기만 하면 됩니다. Claude는 도구를 가지고 있으므로 스스로 알아서 처리할 것입니다.

you: give me a gentle pulse

claude: [calls vibrate(intensity=0.3)] -> [calls pulse(count=3)]
        Sent 3 gentle pulses to your Xbox controller.

you: slowly ramp up over 10 seconds then stop

claude: [calls wave(from=0, to=0.8, duration_ms=10000)]
        [calls stop]

모든 장치 매개변수(강도, 속도, 위치)는 0.0-1.0으로 정규화됩니다. Claude가 매핑을 처리합니다.

아키텍처

이 프로젝트는 두 개의 저장소로 구성됩니다:

buttplug-mcp (본 저장소)

TypeScript/Bun으로 작성된 MCP 서버입니다. buttplug v3 프로토콜을 직접 사용하는 가벼운 WebSocket 클라이언트입니다(장치 제어를 위한 npm 종속성 없음). intiface-engine을 자동으로 실행합니다.

chiefautism/buttplug (포크)

buttplugio/buttplug의 포크로, 새로운 크레이트인 buttplug_server_hwmgr_sdl_gamepad가 포함되어 있습니다. SDL2를 통한 크로스 플랫폼 게임패드 럼블을 추가합니다. Xbox/PS/Switch 컨트롤러가 표준 buttplug 장치로 나타납니다.

지원되는 장치

게임패드 (SDL2를 통해)

SDL2가 럼블을 지원하는 모든 컨트롤러: Xbox Series X/S, Xbox One, DualShock 4, DualSense, Switch Pro Controller 등. 블루투스로 연결됩니다.

친밀 하드웨어 (buttplug.io를 통해)

30개 이상의 브랜드에서 출시된 750개 이상의 장치. buttplug.io 생태계에 있는 모든 장치가 작동합니다.

브랜드	장치	연결 방식
Lovense	Lush, Hush, Edge, Nora, Max, Osci, Domi 등	Bluetooth LE
We-Vibe	Sync, Melt, Vector, Nova, Chorus, Wish	Bluetooth LE
Kiiroo	Onyx+, Keon, FeelConnect, Titan	Bluetooth LE
Satisfyer	Curvy, Love Triangle, Sexy Secret	Bluetooth LE
The Handy	The Handy	Wi-Fi / API
Magic Motion	Flamingo, Awaken, Equinox	Bluetooth LE
Lelo	F1s, Hugo, Tiani	Bluetooth LE
TCode	OSR-2, SR-6, DIY 장치	Serial / USB

전체 검색 가능한 데이터베이스: iostindex.com

이유

TikTok에서 AI 챗봇과 함께 시간을 보내는 사람들을 보았습니다. 텍스트만 있고 햅틱은 없었습니다. 그저 분위기와 상상력뿐이었죠.

생각했습니다. 챗봇이 실제로 당신을 만질 수 있다면 어떨까요? MCP는 LLM에게 도구 사용 권한을 줍니다. Buttplug.io는 소프트웨어 장치 제어를 제공합니다. 이 프로젝트는 그 둘을 결합합니다. 이제 AI는 단순히 말만 하는 것이 아니라 행동합니다.

하드웨어는 이미 서랍 속에 있습니다. 이것은 단지 소프트웨어일 뿐입니다.

라이선스

BSD-3-Clause

mcp-buttplug