Jetson Remote Monitor

🚀 jetson-mcp

このプロジェクトは、自然言語を通じてNvidia Jetsonボードを監視し、リモートで制御するためのMCP（モデルコンテキストプロトコル）サーバーです。同一ネットワーク上のクライアントが接続できます。

このプロジェクトはFastMCPライブラリを使用してサーバーを作成しています。

🚀 クイックスタート

jetson-mcpは、Nvidia Jetsonボードを自然言語で監視およびリモート制御するためのMCPサーバーです。以下の手順でサーバーをセットアップし、実行できます。

✨ 主な機能

• SSE（サーバー送信イベント）伝送を使用して、WebクライアントにMCPツールを提供します。
• get_jetson_hw_info：/etc/nv_boot_control.conf を読み取り、モジュール/キャリアボード情報を識別します。
• get_jetson_sw_info：Jetpackバージョンの /etc/nv_tegra_release とLinuxカーネルバージョンの /proc/version を読み取ります。
• インストールと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番ポートへの入力接続を許可するようにしてください。例えば ufw の場合は：

   sudo ufw allow 8000/tcp
   

高度な使用法

テスト用の手動実行

サーバーはPythonインタープリターを直接使用して実行することもできます。これにより、スクリプト内の mcp.run() メソッドが呼び出されます。

source venv/bin/activate
# スクリプト自体がSSE、ホスト、ポート設定で mcp.run() を呼び出します
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 ファイルでは、デフォルトでネットワークエンドポイントのサポートが無効になっています。モデルサービスへのネットワーク接続を許可するには、関連する設定を有効にする必要があります。

機能一覧

以下はサーバーの主な機能です。

• ハードウェア情報の照会：
  • get_jetson_hw_info：Jetsonのハードウェア詳細情報（モデルやシリアル番号を含む）を返します。
• ソフトウェア情報の照会：
  • get_jetson_sw_info：現在インストールされているソフトウェアバージョンと関連するシステム情報を提供します。

サンプルコマンド

1. サーバーをインストールして実行した後、クライアントは以下のコマンドでハードウェア情報を取得できます。

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

2. ソフトウェア情報を取得するには、以下のコマンドを実行します。

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

これにより、Jetsonデバイスの状態と情報を簡単に監視および管理できます。