Metadata-Version: 2.4
Name: iflow-mcp_zalmotek-jetson-mcp
Version: 0.3.0
Summary: MCP Server for monitoring and controlling a Jetson board (using FastMCP/SSE).
Requires-Python: >=3.8
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: starlette>=0.37.0
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# jetson-mcp

A MCP (Model Context Protocol) server for using natural language to monitor and remotely control a Nvidia Jetson board from clients on the same network.

<p align="center">
  <img src="resources/nvidia_jetson.jpg" alt="Nvidia Jetson">
</p>

This project uses the [FastMCP](https://github.com/jlowin/fastmcp) library to create the server.

**MCP Server Connected:**

<p align="center">
  <img src="resources/mcp_server.png" alt="MCP Server Connected">
</p>

## Features

*   Provides MCP tools accessible by network clients using the SSE (Server-Sent Events) transport.
*   **`get_jetson_hw_info`**: Reads `/etc/nv_boot_control.conf` to identify module/carrier board info.
*   **`get_jetson_sw_info`**: Reads `/etc/nv_tegra_release` (for Jetpack version) and `/proc/version` (for Linux kernel version).
*   Includes scripts for easy installation and systemd service setup.

## Setup and Installation (on the Jetson)

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/Zalmotek/jetson-mcp
    cd jetson-mcp
    ```
2.  **Run the installation script:**
    This script creates a Python virtual environment (`venv/`) and installs dependencies from `requirements.txt`.
    ```bash
    chmod +x install.sh
    ./install.sh
    ```

## Running the Server (on the Jetson)

The recommended way to run the server is as a background service managed by systemd.

1.  **(Optional) Find Jetson IP/Hostname:**
    You'll need the Jetson's IP address or hostname to connect from other devices. Use commands like `ip addr` or `hostname -I`.

2.  **Run the service setup script:**
    This script creates and enables a systemd service file (`/etc/systemd/system/jetson-mcp.service`) configured to run the server as the user who invoked the script, listening on port 8000.
    ```bash
    chmod +x setup_service.sh
    sudo ./setup_service.sh
    ```
3.  **Start the service:**
    ```bash
    sudo systemctl start jetson-mcp.service
    ```
4.  **Verify Service:**
    ```bash
    sudo systemctl status jetson-mcp.service
    # Check logs for errors
    sudo journalctl -u jetson-mcp.service -f
    ```
5.  **Firewall**: Ensure your Jetson's firewall (if active, e.g., `ufw`) allows incoming connections on port 8000 (or your chosen port). Example for `ufw`:
    ```bash
    sudo ufw allow 8000/tcp
    ```

### Running Manually (for testing)

The server is best run directly using the Python interpreter, which will invoke the `mcp.run()` method configured within the script:

```bash
source venv/bin/activate
# The script itself now calls mcp.run() with SSE, host, and port settings
python app/main.py
```

## Connecting from a Remote Client

Once the server is running on the Jetson and accessible on the network (port 8000 allowed through firewall):

1.  **Identify the Server Address**: Find the Jetson's IP address (e.g., `192.168.1.105`) or its hostname (e.g., `jetson-nano.local`) on your LAN.
2.  **Configure Your Client**: In your MCP client application (which could be a custom script, a UI like MCP Inspector, or potentially Cursor/Claude if they support network endpoints), configure it to connect to the MCP server at its network address.
    *   The specific connection method depends on the client, but it will likely involve specifying a URL for the SSE endpoint:
        *   `http://<jetson_ip_or_hostname>:8000/sse` (Common pattern for SSE)


*Note: Cursor's `mcp.json` file is primarily designed for launching local servers via `stdio` transport. Connecting Cursor to this networked SSE server might require different configuration steps or might not be directly supported without a proxy.* Consult your specific client's documentation for how to connect to a network MCP SSE endpoint.

## Examples / Screenshots

**Hardware Info Tool:**

<p align="center">
  <img src="resources/get_hardware_info.png" alt="Hardware Info Tool">
</p>

**Software Info Tool:**

<p align="center">
  <img src="resources/get_software_info.png" alt="Software Info Tool">
</p>

