jetson-mcp

jetson-mcp

同じネットワーク上のクライアントから自然言語で Nvidia Jetson ボードを監視し、リモート制御するための MCP（Model Context Protocol）サーバーです。

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

MCP サーバーに接続済み：

機能

• SSE（Server-Sent Events）トランスポートを使用して、ネットワーククライアントからアクセスできる 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
# The script itself now calls mcp.run() with SSE, host, and port settings
python app/main.py

リモートクライアントからの接続

Jetson 上でサーバーが実行され、ネットワーク経由でアクセスできる状態になったら（ファイアウォールでポート 8000 の通信が許可されていること）：

1. サーバーのアドレスを特定します：LAN 上で 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 ファイルは、主に stdio トランスポートを使用してローカルサーバーを起動するためのものです。Cursor をこのネットワーク上の SSE サーバーに接続するには、異なる設定手順が必要な場合や、プロキシなしでは直接サポートされない場合があります。ネットワーク上の MCP SSE エンドポイントへの接続方法については、お使いのクライアントのドキュメントを参照してください。

例／スクリーンショット

ハードウェア情報ツール：

ソフトウェア情報ツール：