MTIB Server

MCP (Model Context Protocol) server that wraps the MTIB V2 gRPC API, enabling Claude Code to interact with embedded hardware test benches.

Setup

# Install
pip install -e .

# Regenerate proto stubs (if mtib_v2.proto changes)
./generate_proto.sh

Claude Code configuration

Add to .mcp.json:

{
  "mcpServers": {
    "mtib": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "mtib_mcp.server"],
      "env": {
        "MTIB_HOST": "192.168.1.100",
        "MTIB_PORT": "50054"
      }
    }
  }
}

Available tools

Tool	Description
Discovery
mtib_health_check	Check connectivity, version, capabilities
mtib_list_targets	List target devices and debug probes
Flash
mtib_flash	Flash firmware to a target
mtib_reset	Reset a target device
Debug
mtib_debug_connect	Open a debug session (returns session_id)
mtib_debug_disconnect	Close a debug session
mtib_debug_status	Get halt reason, PC, registers
mtib_debug_control	Halt, resume, step, step over
mtib_debug_backtrace	Get stack trace
mtib_debug_memory	Read/write target memory
mtib_debug_breakpoint	Set/clear breakpoints
Serial & Logs
mtib_uart_open	Open UART and start background buffering
mtib_uart_read	Read buffered lines (cursor-based, no data loss)
mtib_uart_close	Close UART stream
mtib_zephyr_shell	Execute a Zephyr shell command
mtib_zephyr_logs_open	Start buffering Zephyr log entries
mtib_zephyr_logs_read	Read buffered log entries (cursor-based)
mtib_zephyr_logs_close	Close log stream
Power
mtib_power_measure	Measure power over a duration
mtib_power_control	Enable/disable/query power channels
Testing
mtib_twister_run	Run Twister test suite
Bus I/O
mtib_i2c_scan	Scan I2C bus
mtib_i2c_transfer	Read/write I2C device

Streaming data guarantee

UART and Zephyr log streams use persistent background buffers. When you call mtib_uart_open, a background task continuously drains the gRPC stream into a 5,000-entry ring buffer. Each entry gets a monotonic sequence number (cursor).

mtib_uart_open(target_id="nrf52840_dk")  →  { stream_key, status: "buffering" }
mtib_uart_read(stream_key, cursor=0)     →  { lines: [...], cursor: 347 }
# ... time passes, DUT keeps printing ...
mtib_uart_read(stream_key, cursor=347)   →  { lines: [...], cursor: 512 }
mtib_uart_close(stream_key)

As long as the ring buffer doesn't wrap (5,000 entries by default), no data is lost between reads.

Environment variables

Variable	Default	Description
MTIB_HOST	localhost	MTIB gRPC server hostname
MTIB_PORT	50054	MTIB gRPC server port