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 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:

   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.

   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.

   chmod +x setup_service.sh
   sudo ./setup_service.sh
   

3. Start the service:

   sudo systemctl start jetson-mcp.service
   

4. Verify Service:

   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:

   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:

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>