MCAI CLI bundle
==============

Files
-----

- mcai.py: Dependency-free Python client (Python 3.10+)
- mcai.sh: Launcher that prefers the Java CLI when installed, otherwise uses Python
- mcai-http.sh: Minimal curl-based client

Quick start
-----------

1. Copy this bundle to your operator computer.
2. Start MCAI on the Paper server once so it creates its local token file.
3. Export the token without placing it in shell history:

   export MCAI_TOKEN="$(cat /path/to/server/plugins/MCAI/token.txt)"

4. Run a command:

   python3 mcai.py status
   python3 mcai.py capabilities
   python3 mcai.py ask "What is the current server status?"

Security
--------

- Keep the MCAI bridge bound to 127.0.0.1.
- Use an SSH tunnel for remote access.
- Never publish token.txt or API keys.
- Mutating actions require confirmation unless the explicit --yes option is used.
