Metadata-Version: 2.4
Name: ellisys-analysis-mcp
Version: 0.1.1
Summary: MCP server for Ellisys protocol analyzers -- drive the Remote Control automation API from AI agents and chat hosts.
Author-email: Ellisys <support@ellisys.com>
License-Expression: GPL-2.0-only
Project-URL: Homepage, https://www.ellisys.com
Project-URL: Documentation, https://downloads.ellisys.com/remote_api_analyzer.zip
Keywords: ellisys,mcp,analyzer,bluetooth,automation,remote-control
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: ellisys-analysis-automation>=0.1.0
Requires-Dist: mcp>=1.2
Provides-Extra: analysis
Requires-Dist: matplotlib; extra == "analysis"
Requires-Dist: pandas; extra == "analysis"

# 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]"` to
have matplotlib and pandas preinstalled.

## Use

Prerequisite: [uv](https://docs.astral.sh/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:

```json
{ "command": "uvx", "args": ["ellisys-analysis-mcp"] }
```

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](https://downloads.ellisys.com/remote_api_analyzer.zip) /
[bta_remote_api.zip](https://downloads.ellisys.com/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).
