wisent-wire-mcp 0.3.0

MCP server for the Wisent Wire hardware testing platform

wisent-wire-mcp

MCP (Model Context Protocol) server for the Wisent Wire hardware testing platform. Lets AI assistants interact with WisentWire devices — power control, firmware flashing, and UART communication.

Installation

Requires Python 3.10+. Install with pipx — it puts the MCP server in an isolated environment and adds the wisentwire-mcp binary to your PATH. No absolute paths in your config, no per-machine venv bookkeeping.

1. Install pipx (one-time)

# macOS
brew install pipx
pipx ensurepath

# Linux / WSL
python3 -m pip install --user pipx
python3 -m pipx ensurepath

Open a new terminal so the updated PATH is picked up.

2. Install the MCP server

pipx install wisent-wire-mcp

Verify:

which wisentwire-mcp          # ~/.local/bin/wisentwire-mcp (or similar)

3. Upgrade / uninstall

pipx upgrade   wisent-wire-mcp
pipx uninstall wisent-wire-mcp

Configuration

.mcp.json location

Claude Code reads MCP servers from .mcp.json. Two scopes:

Scope	Path	When to use
Project	<repo-root>/.mcp.json	Shared with the project (checked into VCS or per-repo)
User	~/.claude.json under the mcpServers key	Available in every Claude Code session for this user

Claude Desktop uses a separate file:

Platform	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Example .mcp.json

Because pipx put wisentwire-mcp on your PATH, the config is portable across machines:

{
  "mcpServers": {
    "wisent-wire": {
      "command": "wisentwire-mcp",
      "env": {
        "WISENT_WIRE_URL": "https://int.wisent-wire.com",
        "WISENT_WIRE_EMAIL": "[e-mail]",
        "WISENT_WIRE_PASSWORD": "..."
      }
    }
  }
}

After editing .mcp.json, restart Claude Code (or reload the window) for the server to be picked up.

Environment variables

Variable	Required	Description
WISENT_WIRE_URL	No	API base URL (default: https://int.wisent-wire.com)
WISENT_WIRE_EMAIL	Yes*	Account email
WISENT_WIRE_PASSWORD	Yes*	Account password
WISENT_WIRE_TOKEN	Yes*	API token (alternative to email/password)
WISENT_WIRE_LOCAL	No	Set to 1 for local development mode

* Provide either TOKEN or EMAIL + PASSWORD.

Available tools

Tool	Description
list_wisentwires	List all WisentWire devices in your organization
get_ww_status	Get detailed device status including power state and lab tools
power_on	Turn on power supply (configurable voltage and current limit)
power_off	Turn off power supply
get_telemetry	Get recent voltage and current readings
flash_firmware	Flash firmware to a device and wait for completion
list_firmware	List available firmware binaries
send_uart_command	Send a text command over UART and return the response
send_uart_hex	Send raw hex bytes over UART
get_uart_log	Get recent UART TX/RX message history

Development

pip install -e ".[dev]"
pytest tests/ -v
ruff check src/ tests/

License

MIT