nt-mcp-server

Un servidor MCP independiente para leer, escribir y monitorear datos de FRC NetworkTables. Permite que un agente de IA hable con las tablas de red de un robot a través del protocolo NetworkTables. El objetivo principal es la simulación local de RobotPy (python -m robotpy sim en 127.0.0.1:5810).

dependencias fijadas (fastmcp==3.4.7, pyntcore==2026.2.2).

Ejecutar el servidor

uv run nt-mcp-server

O, equivalentemente, desde un checkout sin el shim de uv:

python -m nt_mcp_server

El servidor se ejecuta en stdio, que es como los clientes MCP (como opencode) se comunican con él.

Related MCP server: agent-comm

Conectar a RobotPy sim NetworkTables

La simulación debe estar en ejecución antes de que el servidor pueda leer o escribir algo útil. Iníciala desde su propio proyecto y venv:

cd <path-to-try-robotpy> && .venv\Scripts\activate && python -m robotpy sim

El servidor se conecta a 127.0.0.1:5810 por defecto, que es donde escucha la simulación.

Conectar a NetworkTables de un robot real

En la mayoría de los casos, simplemente graba NetworkTables y usa el mcp para analizar las grabaciones.

Si quieres conectarte a NetworkTables de un robot real en tiempo real, necesitas tener 2 adaptadores de red en tu dispositivo: uno para Internet y otro para la comunicación con el robot. Un enfoque es usar tu adaptador inalámbrico para conectarte al wifi y usar un cable Ethernet para conectarte al robot. Alternativamente, puedes obtener un adaptador de red USB como segundo adaptador. En cualquier caso, es posible que necesites configurar el enrutamiento de red de tu dispositivo.

Grabar NetworkTables a NDJSON (sin conexión)

La CLI nt-recorder se conecta a un servidor NT4 en vivo y escribe eventos de valor en un archivo .ndjson con marca de tiempo. Se ejecuta en el portátil de desarrollo y lee NT de la simulación o del robot; no se necesitan cambios en el lado del robot.

uv run nt-recorder --prefixes /SmartDashboard/ --output-dir recordings

Opciones:

• --prefixes — prefijos de temas a los que suscribirse (por defecto: /)

• --output-dir — directorio para archivos de salida (por defecto: ./recordings)

• --duration — grabar durante N segundos y luego salir (por defecto: ejecutar hasta Ctrl+C)

• --team — conectar mediante número de equipo en lugar de IP/puerto del servidor

• --server-ip / --server-port — dirección del servidor NT4 (por defecto: 127.0.0.1:5810)

• --identity — cadena de identidad del cliente (por defecto: nt-recorder)

• --quiet — suprimir la salida de estado en stderr

Los archivos de salida se nombran nt-record-<YYYY-MM-DDTHHMMSSZ>.ndjson (sin dos puntos, seguro para Windows). Cada línea es {"time": float, "topic": str, "value": jsonable}. Códigos de salida: 0 limpio, 1 fallo de conexión, 2 error de disco/IO.

Herramientas

El servidor expone 17 herramientas (13 en vivo + 4 sin conexión). Cada respuesta de herramienta en vivo incluye una bandera connected.

Herramientas en vivo

Herramientas de grabación sin conexión

Las herramientas sin conexión leen del directorio establecido por la variable de entorno NT_RECORDINGS_DIR (por defecto ./recordings). Las grabaciones son solo locales: el grabador se ejecuta en el portátil de desarrollo y lee NT de la simulación/robot; no se necesitan cambios en el lado del robot.

Registrar en cualquier agente

El servidor es un paquete ejecutable con uvx desde git, por lo que cualquier cliente MCP puede lanzarlo sin un checkout local ni un venv preconstruido. Ejecútalo bajo demanda:

uvx --from git+https://github.com/Mzzj114/nt-mcp-server.git nt-mcp-server

O instala el script de consola una vez y ejecútalo en cualquier lugar:

uv tool install "git+https://github.com/Mzzj114/nt-mcp-server.git"
uvx nt-mcp-server

Añade esta entrada a la configuración MCP de tu agente (mostrada aquí como opencode.jsonc a nivel de proyecto):

{
  "mcp": {
    "nt": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/Mzzj114/nt-mcp-server.git",
        "nt-mcp-server"
      ],
      "enabled": true
    }
  }
}

Verifica con opencode mcp list desde la raíz del proyecto: el servidor nt debería mostrarse como conectado.

Desarrollo

• Venv de Python 3.14.0 en .venv; dependencias instaladas desde requirements.txt (fastmcp==3.4.7, pyntcore==2026.2.2).

• Pruebas: uv run pytest tests/ -v

Licencia

Este proyecto está bajo la Licencia MIT.