Name: mcp-buttplug
Author: chiefautism

Сервер MCP, который подключает Claude Code (или любой другой MCP-клиент) к buttplug.io — библиотеке с открытым исходным кодом для управления интимными устройствами. Claude получает инструменты для обнаружения, управления и оркестрации тактильных устройств в режиме реального времени.

Теперь с поддержкой геймпадов. Контроллеры Xbox, PlayStation и Switch работают как вибрационные устройства на macOS, Windows и Linux — благодаря нашему SDL2-форку intiface-engine.

LLM решает, что вы чувствуете и когда.

Как это работает

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

buttplug-mcp автоматически запускает наш форк intiface-engine при вызове команды connect. Не нужно устанавливать или запускать отдельный сервер. Движок обрабатывает:

Геймпады (Xbox/PS/Switch) через SDL2 — кроссплатформенная вибрация
Bluetooth LE игрушки (Lovense, We-Vibe и др.) через btleplug
USB/Serial устройства через драйверы платформы

Начало работы

Предварительные требования

Среда выполнения Bun
Rust toolchain (для сборки 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 и соберет intiface-engine с поддержкой геймпадов SDL2. При первой установке это займет около 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.

Настройка геймпада

Подключите контроллер через Bluetooth (не через USB — вибрация по USB не поддерживается на macOS):

Нажмите и удерживайте кнопку Xbox/PS, пока она не начнет мигать
Нажмите кнопку сопряжения (маленькая кнопка рядом с портом USB на Xbox)
Перейдите в Системные настройки → Bluetooth → Подключить
В Claude Code: connect → scan → ваш контроллер появится в списке

Инструменты

Инструмент	Описание
`connect`	Подключение к Intiface Engine (автоматический запуск при необходимости)
`scan`	Обнаружение устройств (геймпады, Bluetooth, USB)
`devices`	Список подключенных устройств
`vibrate`	Вибрация с интенсивностью `0.0`-`1.0`, опциональный таймер автоотключения
`rotate`	Вращение со скоростью `0.0`-`1.0`
`oscillate`	Осцилляция с интенсивностью `0.0`-`1.0`
`linear`	Перемещение в позицию в течение заданного времени (устройства типа stroker)
`pulse`	Импульсы по шаблону — количество, время включения/выключения, интенсивность
`wave`	Плавное изменение интенсивности между двумя значениями во времени
`stop`	Остановка одного или всех устройств
`battery`	Чтение уровня заряда батареи устройства
`disconnect`	Отключение и остановка движка

Использование

После подключения просто общайтесь с 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 (этот репозиторий)

MCP-сервер на TypeScript/Bun. Легковесный WebSocket-клиент, который напрямую использует протокол buttplug v3 (никаких 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 и другие. Подключаются через Bluetooth.

Интимные устройства (через buttplug.io)

Более 750 устройств от 30+ брендов. Работает всё, что входит в экосистему 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 развлекаются с ИИ-чат-ботами. Только текст. Никакой тактильной отдачи. Только воображение и атмосфера.

Я подумал — что, если бы чат-бот мог по-настоящему коснуться вас? MCP дает LLM возможность использовать инструменты. Buttplug.io дает программное управление устройствами. Это связывает их вместе. Теперь ИИ не просто говорит. Он действует.

Железо уже лежит в ящике стола. Это просто программное обеспечение.

Лицензия

BSD-3-Clause

mcp-buttplug