# DUMANG MCP

毒蟒键盘 MCP 服务，通过 Model Context Protocol 控制 DUMANG DK6 键盘。

## 功能

- **设备发现**：枚举和连接 HID 键盘设备
- **LED 控制**：设置单个按键或全部按键的 LED 颜色
- **键位闪烁**：支持工作键位（WORKING）和完成键位（DONE）闪烁

> 通过vscode的agent hook调用，使用mcptools客户端，脚本放置在hooks文件夹中。

## 安装

```bash
uv sync
```

## 运行

```bash
uv run build
```

## MCP 客户端

使用 [mcptools](https://github.com/anomalyco/mcptools) 调用：

## MCP 工具

| 工具                       | 说明                      |
| -------------------------- | ------------------------- |
| `list_keyboards`           | 枚举已连接的 DK6 HID 设备 |
| `connect_keyboards`        | 连接所有发现的键盘        |
| `list_connected_keyboards` | 列出已连接的键盘          |
| `disconnect_keyboard`      | 断开指定键盘              |
| `set_key_color`            | 设置指定键位 LED 颜色     |
| `set_all_keys_color`       | 设置所有键位为同一颜色    |
| `get_keyboard_keys`        | 获取键盘所有键位信息      |
| `blink_working_keys`       | 闪烁工作键位              |
| `blink_done_keys`          | 闪烁完成键位              |
| `stop_blink_*`             | 停止闪烁                  |

## 技术栈

- Python 3.12+
- [FastMCP](https://github.com/jlowin/fastmcp) - MCP 服务框架
- [hidapi](https://pypi.org/project/hid/) - HID 设备通信
- [Loguru](https://loguru.readthedocs.io/) - 日志

## 联系方式
- wechat：xialugui