jetson-mcp

一个用于通过自然语言监控和远程控制同一网络中客户端的Nvidia Jetson板的MCP（模型上下文协议）服务器。

<p align="center"> <img src="resources/nvidia_jetson.jpg" alt="Nvidia Jetson"> </p>

该项目使用了FastMCP库来创建服务器。

已连接的MCP服务器：

<p align="center"> <img src="resources/mcp_server.png" alt="MCP Server Connected"> </p>

特性

• 提供可通过网络客户端使用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端口（或您选择的端口）的传入连接。例如对于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文件主要用于通过stdio传输启动本地服务器。连接Cursor到这个网络化的SSE服务器可能需要不同的配置步骤，或者如果没有代理可能不直接支持。 咨询您特定客户端的文档，了解如何连接到网络MCP SSE端点。

示例 / 截图

硬件信息工具：

<p align="center"> <img src="resources/get_hardware_info.png" alt="Hardware Info Tool"> </p>

软件信息工具：

<p align="center"> <img src="resources/get_software_info.png" alt="Software Info Tool"> </p>