jetson-mcp

jetson-mcp

一个 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 版本）和 /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
   # Check logs for errors
   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. 识别服务地址：在局域网中查找 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 端点。

示例／截图

硬件信息工具：

软件信息工具：