Metadata-Version: 2.4
Name: ellisys-analysis-mcp
Version: 0.1.0
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

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

## Use

Host configuration (uv self-provisions Python):

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