Ellisys MCP server

An MCP (Model Context Protocol) server that lets AI agents and chat hosts (e.g. Claude Desktop) drive a running Ellisys protocol analyzer through the Remote Control automation API.

Four tools: analysis_guide (the SDK agent guide + recipes), analysis_status (connectivity + analyzer state + markers), analysis_explore (overview/protocol-layer survey, vocabulary, devices, anchors), analysis_run_python (persistent Python session with the SDK preloaded -- all actions and analysis happen here). The session includes install("pkg", ...) for on-demand libraries, show(figure) to return matplotlib figures as images, and attach(path) to return small files (<= 4 MB) with the result. Use uvx "ellisys-analysis-mcp[analysis]@latest" to have matplotlib and pandas preinstalled.

Use

Prerequisite: uv (it provisions Python and the packages; no Python installation needed). Install once -- Windows: winget install astral-sh.uv; macOS: brew install uv; Linux: curl -LsSf https://astral.sh/uv/install.sh | sh -- then verify uvx --version in a new terminal and (re)start your MCP host.

Host configuration:

{ "command": "uvx", "args": ["ellisys-analysis-mcp@latest"] }

The @latest suffix makes uvx pick up new releases on every server start (updating is just a host restart); without it, uvx reuses the first resolved version until uv cache clean ellisys-analysis-mcp. Pin a fixed version with ellisys-analysis-mcp@0.1.3.

The analyzer host/port default to localhost:12345; override with --host/--port arguments or the ELLISYS_HOST/ELLISYS_PORT environment variables. The analyzer application must be running with the Remote Control plugin enabled (see the Remote Control User Guide). File paths in load/save/export operations are resolved on the analyzer machine.

Documentation

The full SDK guide and the per-product Remote Control User Guides ship in the release archives: remote_api_analyzer.zip / bta_remote_api.zip. For agents, the analysis_guide tool returns the authoritative usage guide directly.

License

GPL-2.0-only (like the Remote Control plugin and SDKs, which link ZeroC Ice).