A
licenseNot graded
qualityC
maintenanceProvides full administrative control of OpenWRT routers via SSH, with a preview-confirm safety model for mutating operations.
6 npm
MIT
norns-mcp
by AdairBear
Click on "Deploy 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., "@norns-mcpwhat script is currently running on my norns?"
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.
norns-mcp
MCP server and CLI (nornsctl) for a monome norns on the local network. v0.1.
Status: work in progress, building in public. v0.1 works against a real norns; expect breaking changes.
Shares its device core design with m8-mcp (see docs/CORE.md).
What it does
Tools | Path | |
Reads (any time) |
| SSH ( |
Writes (gated) |
| matron REPL, OSC :10111 |
Deploy (gated) |
| rsync over SSH |
Related MCP server: mcp-remote-docker
Safety
Writes are dry runs unless the server/CLI is started with
--live(the only switch; no env var), and even then each call needsconfirm=true(--confirmon the CLI). A dry run returnsdata.would_send(the exact Lua / OSC / rsync) and sends nothing.No sudo, no system or firmware commands, nothing that deletes on the norns: every remote command goes through an allowlist (
safety.check_remote_argv); rsync never gets--deleteor similar (safety.check_rsync_argv).Deploy: rsync dry run first, always. Live:
cp -abackup of the existing folder to~/norns-mcp-backups/<name>-<UTC>on the norns, backup checked, then push, then per-file SHA-256 check against the Mac.Lua goes to matron as one line with nonce markers (lessons from the iMac norns-mcp-server: multi-line sends corrupt matron's REPL buffer).
The only file written outside deploy is the screenshot temp file
/tmp/norns-mcp-screen.png; screenshot is gated like any write.
Use
uv sync
.venv/bin/nornsctl status # reads
.venv/bin/nornsctl scripts | current | params | get <id> | logs [unit] -n 50 | read awake
.venv/bin/nornsctl inventory --compare-backup --hashes
.venv/bin/nornsctl --live screenshot --confirm # gated: writes one /tmp file on the norns
.venv/bin/nornsctl load awake # DRY RUN
.venv/bin/nornsctl --live load awake --confirm # real (check nobody else is playing first)
.venv/bin/nornsctl deploy ~/path/to/myscript # DRY RUN planMCP (stdio), dry run: .venv/bin/norns-mcp. Live: .venv/bin/norns-mcp --live.
Not registered in any client yet.
Tests
uv run pytest (fakes, no device). uv run pytest -m device (read-only, real norns).
Roadmap
Verify every live write on hardware (keys, encoders, OSC
/parampath)Extract the shared device core into a package used by norns-mcp and m8-mcp
Safe recovery from the SYSTEM > RESTART / JACK hang over SSH
Multi-script coordination from the host (see docs/MULTI-SCRIPT.md)
Packaging and a one-line install for other norns owners
Licence
MIT, see LICENSE.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessUnresponsive
Related MCP Connectors
Read devices, users, keys, ACLs and DNS for a tailnet; manage devices, routes and auth keys.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Securely control computers you explicitly pair through files, terminals, processes, screenshots, desktop UI/input, clipboard, browser automation, diagnostics, and document tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceManages Docker containers, images, and Compose stacks on a remote host over SSH, with file sync and deploy orchestration.MIT
- AlicenseBqualityCmaintenanceEnables control of a local Sonic Pi runtime to run code, stop jobs, read events, and search docs/samples/synthdefs via OSC messages.191MIT
- FlicenseAqualityCmaintenanceEnables managing remote hosts from ~/.ssh/config over OpenSSH, including availability checks, command execution with sudo and timeouts, background jobs, SSH config and known_hosts management, and llms.txt-based documentation retrieval.19-