
buttplug-mcp - Buttplug.io MCP Server

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
的连接处理不稳定,设备控制功能可能无法正常工作。 - 测试设备:缺乏虚拟设备支持,依赖物理设备进行测试。
使用教程
使用依赖
- 下载并安装 Intiface Central 集线器应用程序。
- 启动 Intiface Central 并记录服务器端口(默认为
12345
)。
安装教程
- 通过 Homebrew 安装:
brew tap conacademy/homebrew-tap brew install conacademy/tap/buttplug-mcp
- 或从 GitHub Releases 下载二进制文件。
调试方式
- 使用
task
构建项目:task
- 使用 MCP Inspector Web GUI 进行调试:
npx @modelcontextprotocol/inspector node build/index.js
- 打印 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