Jetson Remote Monitor

🚀 jetson-mcp

jetson-mcp 是一個強大的MCP（模型上下文協議）服務器，它允許用戶通過自然語言對Nvidia Jetson板進行監控和遠程控制。該服務器支持同一網絡上的客戶端連接，為用戶提供便捷的設備管理體驗。

🚀 快速開始

jetson-mcp 藉助 FastMCP 庫創建服務器，讓你可以輕鬆實現對Nvidia Jetson板的監控與遠程控制。

✨ 主要特性

• 高效數據傳輸：使用SSE（服務器發送事件）傳輸，為網絡客戶端提供MCP工具。
• 硬件信息讀取：通過 get_jetson_hw_info 函數，讀取 /etc/nv_boot_control.conf 文件，精準識別模塊/載體板信息。
• 軟件信息查詢：利用 get_jetson_sw_info 函數，讀取 /etc/nv_tegra_release 獲取Jetpack版本，讀取 /proc/version 獲取Linux內核版本。
• 便捷安裝與設置：項目包含腳本，可輕鬆完成安裝和systemd服務設置。

📦 安裝指南

在Jetson上安裝

1. 克隆倉庫

   git clone https://github.com/Zalmotek/jetson-mcp
   cd jetson-mcp
   

2. 運行安裝腳本 此腳本會創建一個Python虛擬環境 (venv/)，並從 requirements.txt 安裝依賴項。

   chmod +x install.sh
   ./install.sh
   

💻 使用示例

運行服務器（在Jetson上）

推薦以systemd背景服務的形式運行服務器，具體步驟如下：

1. （可選）查找Jetson的IP/主機名 你需要Jetson的IP地址或主機名以便其他設備連接，可使用 ip addr 或 hostname -I 命令進行查找。
2. 運行服務設置腳本 該腳本會創建並啟用systemd服務文件 (/etc/systemd/system/jetson-mcp.service)，配置服務器以調用腳本的用戶身份運行，偵聽8000端口。

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

3. 啟動服務

   sudo systemctl start jetson-mcp.service
   

4. 驗證服務狀態

   sudo systemctl status jetson-mcp.service
   # 檢查日誌中的錯誤
   sudo journalctl -u jetson-mcp.service -f
   

5. 防火牆設置 確保Jetson的防火牆（如果有活動，例如 ufw）允許8000端口的傳入連接。

   sudo ufw allow 8000/tcp
   

手動運行（用於測試）

服務器也可以直接使用Python解釋器運行，這將調用腳本中的 mcp.run() 方法。

source venv/bin/activate
# 腳本本身現在會調用 mcp.run() 具有 SSE、主機和端口設置
python app/main.py

從遠程客戶端連接

一旦服務器在Jetson上運行並在網絡上可訪問（8000端口允許通過防火牆），可按以下步驟連接：

1. 識別服務器地址 找到Jetson的IP地址（例如 192.168.1.105）或其主機名（例如 jetson-nano.local）在您的局域網內。
2. 配置客戶端 在您的MCP客戶端應用程序中（可以是自定義腳本、一個像MCP Inspector這樣的UI，或者可能是通過網絡端點支持的Cursor/Claude），配置它連接到MCP服務器的網絡地址。
   • 特定的連接方法取決於客戶端，但它通常涉及指定SSE端點的URL：
     • http://<jetson_ip_or_hostname>:8000/sse（SSE的常見模式）

⚠️ 重要提示

Cursor的 mcp.json 文件中，默認情況下會禁用對網絡端點的支持。需要啟用相關設置以允許通過網絡連接到模型服務。

示例用法

1. 獲取硬件信息 安裝並運行服務器後，客戶端可以通過以下命令獲取硬件信息：

   curl http://localhost:8000/api/hardware
   

2. 獲取軟件信息 要獲取軟件信息，可以運行：

   curl http://localhost:8000/api/software
   

通過以上方式，您可以輕鬆監控和管理Jetson設備的狀態和信息。