buttplug-mcp - Buttplug.io MCP Server

buttplug-mcp - Buttplug.io MCP Server

site icon
2025.04.02 0
Go设备控制LLM 工具支持其它
buttplug-mcp 是一个基于 Buttplug.io 生态系统的 Model Context Protocol (MCP) 服务器,旨在支持工具化的 LLM(大型语言模型)程序查询和控制 Genital Interface Devices(生殖器接口设备)。它提供了设备列表查询、设备信息获取、信号强度检测和电池电量查询等功能,并支持通过工具调用控制设备振动。
View on GitHub

Overview

基本能力

产品定位

buttplug-mcp 是一个为 Buttplug.io 生态系统设计的 MCP 服务器,允许支持工具的 LLM 程序查询和控制连接的 Genital Interface Devices。

核心功能

  • 设备管理:列出连接的设备、获取设备信息、检测信号强度和查询电池电量。
  • 工具支持:提供 device_vibrate 工具,用于控制设备的振动强度和选择特定电机。

适用场景

  • 通过 LLM 程序查询和控制连接的设备。
  • 在开发环境中测试和调试设备控制功能。

工具列表

工具 参数 描述
device_vibrate id, motor, strength 通过设备 ID 控制振动,选择强度和可选电机

常见问题解答

  • 当前状态:项目处于实验阶段,底层库 go-buttplug 的连接处理不稳定,设备控制功能可能无法正常工作。
  • 测试设备:缺乏虚拟设备支持,依赖物理设备进行测试。

使用教程

使用依赖

  1. 下载并安装 Intiface Central 集线器应用程序。
  2. 启动 Intiface Central 并记录服务器端口(默认为 12345)。

安装教程

  1. 通过 Homebrew 安装: brew tap conacademy/homebrew-tap brew install conacademy/tap/buttplug-mcp
  2. 或从 GitHub Releases 下载二进制文件。

调试方式

  1. 使用 task 构建项目: task
  2. 使用 MCP Inspector Web GUI 进行调试: npx @modelcontextprotocol/inspector node build/index.js
  3. 打印 JSON schemas: task stdio-schema | jq

CLI 参数

R buttplug-mcp --help
usage: buttplug-mcp [opts]

  -h, --help              Show help
  -l, --log-file string   Log file destination (or MCP_LOG_FILE envvar). Default is stderr
  -j, --log-json          Log in JSON (default is plaintext)
      --sse               Use SSE Transport (default is STDIO transport)
      --sse-host string   host:port to listen to SSE connections
  -v, --verbose           Verbose logging
      --ws-port int       port to connect to the Buttplug Websocket server

许可证

该项目遵循 MIT 开源许可条款。