Metadata-Version: 2.4
Name: scry-connect
Version: 0.2.0
Summary: MCP server for ROS 2 — exposes robot capabilities as AI-callable tools
Project-URL: Homepage, https://github.com/phaneron-robotics/scry
Project-URL: Documentation, https://phaneron-robotics.github.io/scry-docs/
Project-URL: Repository, https://github.com/phaneron-robotics/scry-connect
Project-URL: Issues, https://github.com/phaneron-robotics/scry-connect/issues
Project-URL: Changelog, https://github.com/phaneron-robotics/scry-connect/blob/master/CHANGELOG.md
Author-email: "Phaneron Robotics, Inc." <info@phaneronrobotics.com>
Maintainer-email: Deep Kotadiya <deep@phaneronrobotics.com>
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: agent,ai,debugging,fleet,introspection,mcp,rclpy,robotics,ros2
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Networking
Classifier: Typing :: Typed
Requires-Dist: mcp>=1.0.0
Requires-Dist: pillow>=10.0
Requires-Dist: psutil>=5.9
Requires-Dist: qrcode>=7.4
Requires-Dist: sse-starlette>=1.8.0
Requires-Dist: starlette>=0.36.0
Requires-Dist: uvicorn>=0.27.0
Requires-Dist: zeroconf>=0.131
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.2.0; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# scry-connect

MCP server for ROS 2 — exposes your robot's topics, nodes, services,
parameters, actions, diagnostics, and ~99 other introspection tools
to AI agents.

Pairs with the [Scry](https://phaneron-robotics.github.io/scry-web/)
Android app for natural-language robot debugging.

## Install

```bash
pip install scry-connect
```

Requires Python 3.10+ and a sourced ROS 2 environment (Humble, Jazzy,
Kilted, Lyrical, or Rolling). The `rclpy` runtime is provided by your
ROS 2 install — no second install required.

## Run

```bash
source /opt/ros/$ROS_DISTRO/setup.bash
scry-connect
```

Defaults to `0.0.0.0:5339`, LAN-only (rejects callers from public IPs).
Open the Scry app on your phone and scan the printed pairing QR.

```bash
scry-connect --token            # require a paired token for all calls
scry-connect --mtls             # mutual TLS for production deployments
```

## Other install paths

For Docker, sidecar deployments, or the one-line installer, see the
[scry-web install guide](https://phaneron-robotics.github.io/scry-web/get-started/install-connect/).

## Links

- **Docs:** <https://phaneron-robotics.github.io/scry-web/>
- **Source:** <https://github.com/phaneron-robotics/scry-connect>
- **Issues:** <https://github.com/phaneron-robotics/scry-connect/issues>

## License

Apache-2.0
