Name: mcp-buttplug
Author: chiefautism

Ein MCP-Server, der Claude Code (oder jeden anderen MCP-Client) mit buttplug.io verbindet – der Open-Source-Bibliothek zur Steuerung intimer Hardware. Claude erhält Werkzeuge, um haptische Geräte in Echtzeit zu entdecken, zu steuern und zu orchestrieren.

Jetzt mit Gamepad-Unterstützung. Xbox-, PlayStation- und Switch-Controller funktionieren als Vibrationsgeräte unter macOS, Windows und Linux – ermöglicht durch unseren SDL2-Fork von intiface-engine.

Das LLM entscheidet, was du fühlst und wann.

Funktionsweise

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

buttplug-mcp startet automatisch unsere geforkte intiface-engine, wenn du connect aufrufst. Es muss kein separater Server installiert oder ausgeführt werden. Die Engine kümmert sich um:

Gamepads (Xbox/PS/Switch) via SDL2 – plattformübergreifendes Rumble
Bluetooth LE-Spielzeuge (Lovense, We-Vibe, etc.) via btleplug
USB/Serielle Geräte via Plattform-Treiber

Erste Schritte

Voraussetzungen

Bun Laufzeitumgebung
Rust-Toolchain (zum Bauen der intiface-engine)
cmake (für SDL2)

Installation

# 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 klont automatisch unseren buttplug-Fork und baut die intiface-engine mit SDL2-Gamepad-Unterstützung. Dies dauert bei der ersten Installation etwa 2 Minuten.

Zu Claude Code hinzufügen

Erstelle oder bearbeite ~/.claude/.mcp.json:

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

Los geht's

Starte Claude Code neu. Die Werkzeuge sind sofort verfügbar.

you: connect and scan for devices

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

Gamepad-Einrichtung

Verbinde deinen Controller via Bluetooth (nicht USB – USB-Rumble wird unter macOS nicht unterstützt):

Halte die Xbox/PS-Taste gedrückt, bis sie blinkt
Drücke die Pairing-Taste (kleine Taste in der Nähe des USB-Anschlusses bei Xbox)
Gehe zu Systemeinstellungen → Bluetooth → Verbinden
In Claude Code: connect → scan → dein Controller erscheint

Werkzeuge

Werkzeug	Beschreibung
`connect`	Verbindung zur Intiface Engine herstellen (startet bei Bedarf automatisch)
`scan`	Geräte entdecken (Gamepads, Bluetooth, USB)
`devices`	Liste verbundener Geräte anzeigen
`vibrate`	Vibrieren mit Intensität `0.0`-`1.0`, optionaler Auto-Stopp-Timer
`rotate`	Rotieren mit Geschwindigkeit `0.0`-`1.0`
`oscillate`	Oszillieren mit Intensität `0.0`-`1.0`
`linear`	Bewegung zu einer Position über eine bestimmte Dauer (Stroker-Geräte)
`pulse`	Pulsierende Muster – Anzahl, An/Aus-Timing, Intensität
`wave`	Sanfter Übergang zwischen zwei Intensitäten über Zeit
`stop`	Ein oder alle Geräte stoppen
`battery`	Batteriestand des Geräts ablesen
`disconnect`	Verbindung trennen und Engine stoppen

Verwendung

Sobald die Verbindung steht, sprich einfach mit Claude. Es hat die Werkzeuge – es wird herausfinden, wie sie zu nutzen sind.

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]

Alle Geräteparameter (Intensität, Geschwindigkeit, Position) sind auf 0.0-1.0 normalisiert. Claude übernimmt die Zuordnung.

Architektur

Dieses Projekt besteht aus zwei Repositories:

buttplug-mcp (dieses Repo)

MCP-Server in TypeScript/Bun. Schlanker WebSocket-Client, der direkt das buttplug v3-Protokoll spricht (keine npm-Abhängigkeiten für die Gerätesteuerung). Startet intiface-engine automatisch.

chiefautism/buttplug (Fork)

Fork von buttplugio/buttplug mit einem neuen Crate: buttplug_server_hwmgr_sdl_gamepad. Fügt plattformübergreifendes Gamepad-Rumble via SDL2 hinzu. Xbox/PS/Switch-Controller erscheinen als Standard-buttplug-Geräte.

Unterstützte Geräte

Gamepads (via SDL2)

Jeder Controller, den SDL2 mit Rumble unterstützt: Xbox Series X/S, Xbox One, DualShock 4, DualSense, Switch Pro Controller und mehr. Verbunden via Bluetooth.

Intime Hardware (via buttplug.io)

Über 750 Geräte von mehr als 30 Marken. Alles, was im buttplug.io-Ökosystem funktioniert.

Marke	Geräte	Verbindung
Lovense	Lush, Hush, Edge, Nora, Max, Osci, Domi und mehr	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-Geräte	Seriell / USB

Vollständige durchsuchbare Datenbank: iostindex.com

Warum

Ich habe Mädchen auf TikTok gesehen, die mit KI-Chatbots "goonen". Nur Text. Keine Haptik. Nur Vibes und Fantasie.

Mein Gedanke: Was wäre, wenn der Chatbot dich tatsächlich berühren könnte? MCP gibt LLMs Werkzeugnutzung. Buttplug.io gibt Software die Gerätesteuerung. Das hier verbindet beides. Jetzt spricht die KI nicht nur. Sie handelt.

Die Hardware liegt bereits in der Schublade. Das hier ist nur die Software.

Lizenz

BSD-3-Clause

mcp-buttplug