mcp-buttplug

Сервер 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 устройства через драйверы платформы

Related MCP server: jlbloomer-mcp-server

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

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

• Среда выполнения 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):

1. Нажмите и удерживайте кнопку Xbox/PS, пока она не начнет мигать

2. Нажмите кнопку сопряжения (маленькая кнопка рядом с портом USB на Xbox)

3. Перейдите в Системные настройки → Bluetooth → Подключить

4. В Claude Code: connect → scan → ваш контроллер появится в списке

Инструменты

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

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

Полная база данных с поиском: iostindex.com

Зачем

Я видел, как девушки в TikTok развлекаются с ИИ-чат-ботами. Только текст. Никакой тактильной отдачи. Только воображение и атмосфера.

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

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

Лицензия

BSD-3-Clause