ellisys-analysis-mcp 0.1.2

MCP server for Ellisys protocol analyzers -- drive the Remote Control automation API from AI agents and chat hosts.

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.1.

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).