MCP (Model Context Protocol) 서버는 자연적인 언어를 사용하여 모니터하고 동시에 동일한 네트워크에 클라이언트에서 Nvidia Jetson 보드를 제어합니다.

이 프로젝트는 FastMCP 라이브러리를 사용하여 서버를 만듭니다.

** MCP 서버 연결 : **

특징

• SSE (Server-Sent Events) 운송을 사용하여 네트워크 클라이언트에서 MCP 도구를 제공합니다.
• get_jetson_hw_info: 모듈/카리어보드 정보를 식별하기 위해 /etc/nv_boot_control.conf을 읽습니다. *get_jetson_sw_info: /etc/nv_tegra_release]( Jetpack version) 및 /proc/version](Linux 커널 버전용)를 읽습니다.
• 쉬운 임명과 systemd 서비스 체제를 위한 스크립트를 포함합니다.

설치 및 설치 ( Jetson에)

1. ** 저장소 : **

2. ** 설치 스크립트:** 이 스크립트는 Python 가상 환경(venv/])을 생성하고 requirements.txt]에서 의존성을 설치합니다.

서버 실행 ( Jetson에)

서버를 실행하는 권장 방법은 systemd에 의해 관리 된 배경 서비스입니다.

1. ** (선택) Jetson IP/Hostname 찾기: ** Jetson의 IP 주소 또는 다른 장치에서 연결할 호스트 이름이 필요합니다. ip addr 또는 hostname -I]와 같은 명령을 사용하십시오.

2. 명세.

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.

This project uses the FastMCP library to create the server.

MCP Server Connected:

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.