mcp-buttplug

Un servidor MCP que conecta Claude Code (o cualquier cliente MCP) a buttplug.io, la biblioteca de control de hardware íntimo de código abierto. Claude obtiene herramientas para descubrir, controlar y orquestar dispositivos hápticos en tiempo real.

Ahora con soporte para mandos de juego. Los mandos de Xbox, PlayStation y Switch funcionan como dispositivos de vibración en macOS, Windows y Linux, impulsados por nuestra versión bifurcada de intiface-engine con SDL2.

El LLM decide qué sientes y cuándo.

Cómo funciona

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

buttplug-mcp inicia automáticamente nuestra versión bifurcada de intiface-engine cuando llamas a connect. No hay ningún servidor adicional que instalar o ejecutar. El motor gestiona:

• Mandos de juego (Xbox/PS/Switch) a través de SDL2: vibración multiplataforma

• Juguetes Bluetooth LE (Lovense, We-Vibe, etc.) a través de btleplug

• Dispositivos USB/Serie a través de controladores de plataforma

Related MCP server: jlbloomer-mcp-server

Primeros pasos

Requisitos previos

• Entorno de ejecución Bun

• Cadena de herramientas Rust (para compilar intiface-engine)

• cmake (para SDL2)

Instalación

# 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 clonará automáticamente nuestra bifurcación de buttplug y compilará intiface-engine con soporte para mandos de juego SDL2. Esto toma aproximadamente 2 minutos en la primera instalación.

Añadir a Claude Code

Crea o edita ~/.claude/.mcp.json:

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

Ejecución

Reinicia Claude Code. Las herramientas estarán disponibles inmediatamente.

you: connect and scan for devices

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

Configuración del mando de juego

Conecta tu mando a través de Bluetooth (no USB; la vibración por USB no es compatible en macOS):

1. Mantén presionado el botón Xbox/PS hasta que parpadee

2. Presiona el botón de emparejamiento (botón pequeño cerca del puerto USB en Xbox)

3. Ve a Configuración del sistema → Bluetooth → Conectar

4. En Claude Code: connect → scan → tu mando aparecerá

Herramientas

Uso

Una vez conectado, simplemente habla con Claude. Tiene las herramientas; él se encargará de todo.

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]

Todos los parámetros del dispositivo (intensidad, velocidad, posición) están normalizados a 0.0-1.0. Claude se encarga del mapeo.

Arquitectura

Este proyecto consta de dos repositorios:

buttplug-mcp (este repositorio)

Servidor MCP en TypeScript/Bun. Cliente WebSocket ligero que habla el protocolo buttplug v3 directamente (sin dependencias npm para el control de dispositivos). Inicia automáticamente intiface-engine.

chiefautism/buttplug (bifurcación)

Bifurcación de buttplugio/buttplug con un nuevo crate: buttplug_server_hwmgr_sdl_gamepad. Añade vibración de mando multiplataforma a través de SDL2. Los mandos de Xbox/PS/Switch aparecen como dispositivos buttplug estándar.

Dispositivos compatibles

Mandos de juego (vía SDL2)

Cualquier mando que SDL2 soporte con vibración: Xbox Series X/S, Xbox One, DualShock 4, DualSense, Switch Pro Controller y más. Conectados vía Bluetooth.

Hardware íntimo (vía buttplug.io)

Más de 750 dispositivos de más de 30 marcas. Cualquier cosa en el ecosistema buttplug.io funciona.

Base de datos completa y buscable: iostindex.com

Por qué

Vi a chicas en TikTok usando chatbots de IA. Solo texto. Sin háptica. Solo vibras e imaginación.

Pensé: ¿qué pasaría si el chatbot realmente pudiera tocarte? MCP proporciona el uso de herramientas a los LLM. Buttplug.io proporciona el control de dispositivos por software. Esto los une. Ahora la IA no solo habla. Actúa.

El hardware ya está en el cajón. Esto es solo el software.

Licencia

BSD-3-Clause