A
license-
qualityC
maintenanceBluetooth Low Energy (BLE) MCP server that allows AI agents to scan, connect to and communicated with BLE devices, as well as simulate BLE perhipherals.
14
BSD 2-Clause "Simplified"
DG-MCP
by 0xNullAI
The DG-MCP server lets you control DG-Lab Coyote 2.0/3.0 electrical stimulation devices via Bluetooth through any MCP-compatible LLM client (e.g., Claude Desktop).
Device Discovery & Connection
scan— Discover nearby Coyote devices (address, name, version)connect— Connect to a device via BLE addressdisconnect— Disconnect from the current deviceget_status— Query connection status, strength levels, active waveform, and battery
Channel Control
start— Start a channel (A/B) with initial strength (0–10) and a waveform (breath, tide, pulse_low, pulse_mid, pulse_high, tap)stop— Stop one or both channelsadjust_strength— Incrementally adjust a running channel's strength (±10 per step)change_wave— Switch waveform on a running channel without changing strengthburst— Briefly spike a channel to a target strength for 100–5000ms, then auto-returnemergency_stop— Immediately zero all strength and stop all waveforms
Waveform Management
list_waveforms— List all available waveforms (built-in + imported)load_waveforms— Import waveforms from.pulsefiles or.ziparchives at runtimedesign_wave— Create custom waveforms using composable segments:ramp(linear change),hold(constant),pulse(on/off beats),silence(quiet interval); optionally play immediately on a channel
Utility
timer— Set a countdown timer (1–3600s) for deferred follow-up actions within a conversation flow
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DG-MCPScan for nearby Coyote devices."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DG-MCP
让 Claude Desktop 等 MCP 客户端直接控制 DG-Lab 郊狼 2.0 / 3.0
中文 | English
这是什么
DG-MCP 把郊狼设备暴露成一组 Model Context Protocol 工具，让任何 MCP 兼容的 LLM 客户端（Claude Desktop、Continue 等）能通过蓝牙直接驱动你的设备——scan / connect / shock_start / shock_stop / shock_adjust / shock_change_wave / shock_burst / design_wave / emergency_stop 全套都是普通的工具调用（旧版 start / stop / adjust_strength / change_wave / burst 名字仍可调用，但工具列表只展示新名）。
跑在 Node.js 里，通过 stdio 跟客户端通信。基于 @dg-kit/* 中台，跟 DG-Agent / DG-Chat 共享一份协议代码。
Related MCP server: BLE MCP Server
状态
1.0.0正式版，已发布到 npmv0.1.x 的 Python 实现归档在
archive/0.x-py分支，PyPI 上仍可下载但不再更新
快速开始
安装
不需要预装，npx 直接拉：
npx dg-mcp --version或者全局装：
npm install -g dg-mcpClaude Desktop 配置
打开 Claude Desktop 的配置文件，加入：
{
"mcpServers": {
"dg-lab": {
"command": "npx",
"args": ["-y", "dg-mcp"]
}
}
}要预加载波形包：
{
"mcpServers": {
"dg-lab": {
"command": "npx",
"args": ["-y", "dg-mcp", "--waveforms-dir", "/Users/you/wave-pack"]
}
}
}重启 Claude Desktop，对话框里跟 Claude 说"扫描一下郊狼"，它就会调 scan 工具找设备。
CLI 选项
dg-mcp [options]
--waveforms <path> 启动时加载一个 .pulse 或 .zip 文件（可重复）
--waveforms-dir <dir> 加载目录下所有 .pulse / .zip
--library-dir <dir> 用户导入的 / AI 设计的波形持久化到这个目录
--help, -h
--version, -v
环境变量等价：
DG_MCP_WAVEFORMS 冒号分隔的多路径
DG_MCP_WAVEFORMS_DIR 同 --waveforms-dir
DG_MCP_LIBRARY_DIR 同 --library-dir工具列表
设备控制（来自 @dg-kit/tools）
工具 | 用途 |
| 冷启动通道，一次设强度 + 波形（旧名 |
| 停止通道；省略 |
| 相对调整强度（±10/步，5s 内最多 2 次）（旧名 |
| 不动强度，仅换波形（旧名 |
| 短时拉到目标强度后自动回落（5s 内最多 1 次）（旧名 |
| 用 |
| 负鼠设备启动通道振动，可选带 |
| 停止负鼠振动；省略 |
| 相对调整负鼠振动强度（5s 内最多 2 次） |
| 不动强度，仅切换负鼠振动节奏预设 |
| 负鼠短时脉冲后自动回落（5s 内最多 1 次） |
| 设置爪印 / 灵猫边缘控制 / 负鼠的指示灯颜色，纯外观 |
MCP 专属
工具 | 用途 |
| 扫描附近设备 |
| 蓝牙连接管理 |
| 当前连接 / 强度 / 波形 / 电池 |
| 列出所有可用波形 |
| 运行时导入新的 |
| 立即归零 |
安全
强度量程是 0-200。冷启动工具自动钳制初始强度 ≤10，请从低强度开始
默认软上限是 200；如果你需要更严格的硬限制，让 LLM 客户端策略层加约束
设备物理拨轮可以单独叠加强度——MCP 只是输入源，不是绝对天花板
任何时候说"紧急停止"，AI 会调
emergency_stop立即归零
系统要求
Node.js ≥ 20
支持 BLE 的主机（macOS / Linux 走 BlueZ / Windows 配 noble 兼容适配器）
DG-Lab 郊狼 2.0（D-LAB ESTIM…）或 3.0（47L121…）
macOS
首次跑会弹蓝牙权限申请，允许即可。
Linux
noble 需要 BLE 抓包权限：
sudo setcap cap_net_raw+eip $(eval readlink -f $(which node))架构
┌─────────────────────┐
│ MCP 客户端 │ Claude Desktop / Continue / ...
└──────────┬──────────┘
│ stdio
┌──────────▼──────────┐
│ dg-mcp │ 本仓库
├─────────────────────┤
│ src/server.ts │ → 把 @dg-kit/tools 工具定义转 MCP schema
│ src/coyote-device │ → DeviceClient，驱动 @dg-kit/protocol
│ src/waveform-lib │ → 内置 + .pulse/.zip + JSON 持久化
│ src/noble-shim │ → noble Characteristic → CharacteristicLike
└──────────┬──────────┘
│ shared
┌──────────▼──────────┐
│ @dg-kit/* │ core / protocol / tools / waveforms
└─────────────────────┘
│ BLE
┌──────────▼──────────┐
│ Coyote 2.0 / 3.0 │
└─────────────────────┘开发
git clone https://github.com/0xNullAI/DG-MCP.git
cd DG-MCP
npm install
npm run build
npm run dev # tsx 热重载相关项目
协议
Maintenance
–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceA stateful Bluetooth Low Energy (BLE) MCP server that enables AI agents to scan, connect, read/write characteristics, and subscribe to notifications on BLE devices.3515MIT
- Alicense-qualityDmaintenanceMCP server for controlling compatible boards over Bluetooth serial, including DC motors, servos, IO, and sensors.MIT
- Alicense-qualityBmaintenanceEnables tracking and monitoring of Capillus Bluetooth caps for treatment sessions, adherence, and device status using local BLE data, without requiring cloud APIs.MIT
Related MCP Connectors
Remote MCP for MCP consent scope receipt, structured receipts, audit logs, and reviewer-ready eviden
pub.dev MCP — package registry for Dart & Flutter.
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/0xNullAI/DG-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server