Skip to main content
Glama
cocopon

m8-tracker-mcp

by cocopon
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

m8-tracker-mcp

Unofficial MCP server for controlling a Dirtywave M8 over USB.

It reads the M8 screen as text, presses buttons, and plays notes.

Requirements

  • Node.js 20 or later

  • M8 connected over USB

Tested with M8 Model:01 on firmware 6.6.3 (macOS). Cursor detection assumes firmware 6.x.

Only one app can open the M8's serial port at a time. Close m8c or other clients, or call disconnect first.

Related MCP server: clawtouch-mcp

Tools

Tool

Description

get_screen

Read the screen as text

press_buttons

Press buttons

press_sequence

Press a series of buttons

press_note

Press a note key (keyjazz)

get_system_info

Get the model and firmware version

connect / disconnect

Open or release the serial port

Button names follow the M8 labels: up, down, left, right, shift, play, option, edit.

Screen format

get_screen returns the palette, the screen, and the cursor position:

=== Palette ===
a fg=#787c90 bg=#303440
b fg=#404050 bg=#303440
...

=== Screen ===
 {e}SONG
...
 00 {b}-- -- -- -- -- -- -- --
...

=== Cursor ===
line 14, columns 23-24: "--"

{x} switches to palette slot x, and each line starts with slot a. Cursor columns don't count the tags.

Development

npm install
npm run dev
npm run build
npm test

Tests replay serial data recorded from a real M8 in fixtures/. To record a new one, run npm run capture -- <name> and check <name>.txt against the device.

Acknowledgments

Serial protocol handling was implemented with reference to m8c by Jonne Kokkonen.

License

MIT License. See LICENSE for more information.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • clawtouch-mcp

    tinqiao-oss
    A
    license
    A
    quality
    A
    maintenance
    Turns a real USB HID device — a Raspberry Pi Pico 2 running open-source firmware — into MCP tools (move, click, drag, type, key combos, scroll) for any MCP client. Includes a --mock mode to try every tool with no hardware.
    16
    83 PyPI
    13
    MIT

  • flipper-mcp

    yairhdz24
    A
    license
    B
    quality
    D
    maintenance
    MCP server that enables full control of a Flipper Zero device over USB, including screenshots, radio protocols, and app development without requiring a COM port.
    35
    MIT