Jetson MCP Server

jetson-mcp

Un servidor MCP (Protocolo de contexto de modelo) para utilizar lenguaje natural para monitorear y controlar de forma remota una placa Nvidia Jetson desde clientes en la misma red.

Este proyecto utiliza la biblioteca FastMCP para crear el servidor.

Servidor MCP conectado:

Características

• Proporciona herramientas MCP a las que pueden acceder los clientes de la red mediante el transporte SSE (eventos enviados por el servidor).
• get_jetson_hw_info : lee /etc/nv_boot_control.conf para identificar la información del módulo/placa portadora.
• get_jetson_sw_info : lee /etc/nv_tegra_release (para la versión Jetpack) y /proc/version (para la versión del kernel de Linux).
• Incluye scripts para una fácil instalación y configuración del servicio systemd.

Configuración e instalación (en el Jetson)

1. Clonar el repositorio:
   git clone https://github.com/Zalmotek/jetson-mcp cd jetson-mcp
2. Ejecutar el script de instalación: Este script crea un entorno virtual de Python ( venv/ ) e instala dependencias desde requirements.txt .
   chmod +x install.sh ./install.sh

Ejecución del servidor (en Jetson)

La forma recomendada de ejecutar el servidor es como un servicio en segundo plano administrado por systemd.

1. (Opcional) Buscar la IP/nombre de host de Jetson: Necesitará la dirección IP o el nombre de host de Jetson para conectarse desde otros dispositivos. Use comandos como ip addr o hostname -I .
2. Ejecutar el script de configuración del servicio: este script crea y habilita un archivo de servicio systemd ( /etc/systemd/system/jetson-mcp.service ) configurado para ejecutar el servidor como el usuario que invocó el script, escuchando en el puerto 8000.
   chmod +x setup_service.sh sudo ./setup_service.sh
3. Iniciar el servicio:
   sudo systemctl start jetson-mcp.service
4. Verificar servicio:
   sudo systemctl status jetson-mcp.service # Check logs for errors sudo journalctl -u jetson-mcp.service -f
5. Cortafuegos : Asegúrese de que el cortafuegos de su Jetson (si está activo, p. ej., ufw ) permita conexiones entrantes en el puerto 8000 (o el puerto que elija). Ejemplo para ufw :
   sudo ufw allow 8000/tcp

Ejecutar manualmente (para pruebas)

El servidor se ejecuta mejor directamente utilizando el intérprete de Python, que invocará el método mcp.run() configurado dentro del script:

Conexión desde un cliente remoto

Una vez que el servidor se esté ejecutando en Jetson y sea accesible en la red (puerto 8000 permitido a través del firewall):

1. Identifique la dirección del servidor : busque la dirección IP de Jetson (por ejemplo, 192.168.1.105 ) o su nombre de host (por ejemplo, jetson-nano.local ) en su LAN.
2. Configure su cliente : en su aplicación cliente MCP (que podría ser un script personalizado, una interfaz de usuario como MCP Inspector o potencialmente Cursor/Claude si admiten puntos finales de red), configúrelo para conectarse al servidor MCP en su dirección de red.
   • El método de conexión específico depende del cliente, pero probablemente implicará especificar una URL para el punto final SSE:
     • http://<jetson_ip_or_hostname>:8000/sse (Patrón común para SSE)

Nota: El archivo mcp.json de Cursor está diseñado principalmente para iniciar servidores locales mediante el transporte stdio . Conectar Cursor a este servidor SSE en red podría requerir pasos de configuración diferentes o podría no ser compatible directamente sin un proxy. Consulte la documentación de su cliente para saber cómo conectarse a un punto final SSE de MCP en red.

Ejemplos / Capturas de pantalla

Herramienta de información de hardware:

Herramienta de información de software: