SerialRUN
One serial tool for terminal work, Modbus/PLC debugging, CAN and I²C/SPI analysis, firmware flashing — plus an MCP server that lets AI agents drive the port.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirEnglish | 简体中文
Download · Features · MCP server · Documentation · Website
Latest: v0.4.6 — what's new · all releases
The website detects your OS and points the main button at the right installer: www.serialrun.com.
Windows — run the setup for Start Menu shortcuts and an uninstaller; the portable
ZIP needs no installation and also contains serialrun-cli.exe and serialrun-mcp.exe.
macOS — Apple Silicon (M1–M4) needs the arm64 build, Intel Macs need the x64 build.
The builds are ad-hoc signed (not notarized), so on first launch use
right-click → Open. If macOS reports the app as damaged, run
xattr -dr com.apple.quarantine /Applications/SerialRUN.app once and open it again.
Linux — sudo apt install ./serialrun_0.4.6_amd64.deb installs serialrun,
serialrun-cli and serialrun-mcp into /usr/bin and resolves dependencies.
For the tarball, extract and run ./serialrun. Runtime dependencies (Ubuntu/Debian):
sudo apt install libudev1 libxkbcommon0 libx11-6 libxcursor1 libxrandr2 libxi6 libgl1 libwayland-client0
All packages are built automatically by GitHub Actions for every release — see the release workflow and docs/RELEASE_SOP.md.
Every panel is an independent OS window — open Modbus, PLC, CAN, Scope or any other tool from the top bar and drag it anywhere, including onto a second monitor.
The packages include serialrun-cli for scripted work:
# List available ports
serialrun-cli list
# Connect, send, and monitor
serialrun-cli send COM1 "Hello\r\n"
serialrun-cli monitor COM1 -t -l output.log
# Record and replay a session
serialrun-cli record COM1 -o script.txt
serialrun-cli replay COM1 script.txt
serialrun-cli agent list-ports # List ports (JSON)
serialrun-cli agent COM1 send "AT+RST" # Send data
serialrun-cli agent COM1 read --timeout 1000 # Read data
serialrun-cli agent COM1 run-script test.txt # Run a script
Serial debugging usually means juggling a terminal for raw I/O, another tool for Modbus registers, a vendor utility for PLCs, and a separate viewer for CAN or I²C/SPI traffic. SerialRUN puts them behind one multi-window UI and adds an MCP server so AI assistants can operate the same port under your supervision.
Based on the default, publicly documented feature sets as of October 2026.
~/.serialrun/sudo usermod -aG dialout $USER (uucp on Arch-based distributions).127.0.0.1:9527 by default and can be switched
to LAN mode in the GUI; the port is configurable.SerialRUN embeds an MCP server so AI assistants and scripts can inspect the port,
send commands and read Modbus registers through the same connection the GUI uses.
Enable it in the GUI sidebar (default 127.0.0.1:9527); every call is written to the
access log with the client IP.
The server speaks JSON-RPC 2.0 over TCP:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_ports","arguments":{}}}' \
| nc 127.0.0.1 9527
From an MCP client, call tools such as connect, send_command, modbus_read or
read. A stdio bridge and Python/Node examples are in
docs/MCP_API.md.
All operations are logged with the client IP, multiple clients can connect concurrently, and the access log is visible in the GUI settings panel.
If a problem persists, open an issue with your OS version, adapter model, and the relevant log lines. Device dumps may contain sensitive payloads — redact them first.
All panels run as independent OS windows — drag, resize, and arrange freely. Child windows always stay on top of the main window.
SerialRUN/
├── crates/
│ ├── serialrun-core/ # Core library (port, protocol, checksum, data logger)
│ ├── serialrun-cli/ # CLI application
│ ├── serialrun-gui/ # GUI application (egui/eframe)
│ ├── serialrun-mcp/ # MCP server for AI integration
│ ├── serialrun-mobile/ # Android USB serial adapter
│ ├── serialrun-mobile-app/ # Android app (eframe/egui)
│ └── serialrun-plugin-api/ # Plugin API definitions
├── plugins/
│ └── serialrun-example-plugin/ # Plugin example (C FFI)
├── assets/ # Embedded images and icons
├── docs/ # Documentation
├── tests/ # Integration tests
└── benches/ # Benchmarks
SerialRUN automatically saves data to ~/.serialrun/ directory:
#[no_mangle]
pub extern "C" fn plugin_get_info() -> *mut c_char { /* ... */ }
#[no_mangle]
pub extern "C" fn plugin_execute(command: *const c_char, params: *const c_char) -> *mut c_char { /* ... */ }
See plugins/serialrun-example-plugin/ for a complete example.
cargo build # Build all crates
cargo test # Run tests
cargo bench # Run benchmarks
git clone https://github.com/YaoIsAI/SerialRUN.git
cd SerialRUN
cargo build --release
# Windows: target/release/serialrun.exe
# macOS: target/release/serialrun
# Linux: target/release/serialrun
# macOS .app bundle:
make app
See docs/BUILD.md for detailed platform-specific instructions.
Contributions are welcome — bug reports, protocol corrections, translations and pull requests all help.
cargo fmt --all and cargo test --workspace before opening it. CI builds on
Windows, macOS and Linux.plugins/serialrun-example-plugin/ and see
docs/MCP_API.md for the tool surface.Planned work, subject to change — discuss priorities in Discussions:
If SerialRUN helps your work, consider giving the project a star — it helps other embedded developers find it.
Donations help cover build machines, code-signing and hosting.
SerialRUN is source-available under the Business Source License 1.1, which converts to the MIT License on 2030-05-31 or on the date the licensor announces the change, whichever is earlier. Non-commercial use is unrestricted, and businesses may use it for evaluation, internal testing and development. Commercial use requires a separate license, and modified versions may not be distributed without one; unmodified copies may be redistributed. See LICENSE for the exact terms.
Made with ❤️ for embedded developers
Professional Serial Port Debugging Assistant with Modbus, PLC, CAN, I2C/SPI support and MCP server
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
SerialRUN roda localmente via stdio.
Última verificação: 2026-10-28. Professional Serial Port Debugging Assistant with Modbus, PLC, CAN, I2C/SPI support and MCP server