nt-mcp-server

Автономный MCP-сервер для чтения, записи и мониторинга данных NetworkTables во FRC. Он позволяет ИИ-агенту обмениваться данными с роботом по протоколу NetworkTables. Основная цель — локальная симуляция RobotPy (python -m robotpy sim на 127.0.0.1:5810).

закреплённые зависимости (fastmcp==3.4.7, pyntcore==2026.2.2).

Запуск сервера

uv run nt-mcp-server

Или, из локальной копии репозитория без использования uv:

python -m nt_mcp_server

Сервер работает через stdio — именно так MCP-клиенты (например, opencode) подключаются к нему.

Related MCP server: agent-comm

Подключение к симуляции RobotPy NetworkTables

Перед чтением или записью данных симуляция должна быть запущена. Запустите её из своего проекта и виртуального окружения:

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

По умолчанию сервер подключается к 127.0.0.1:5810 — именно там работает симуляция.

Подключение к реальному роботу NetworkTables

В большинстве случаев достаточно записать данные и проанализировать их с помощью MCP.

Если нужно подключиться к реальному роботу в реальном времени, потребуется два сетевых адаптера на устройстве: один для интернета, другой для связи с роботом. Один из вариантов — использовать беспроводной адаптер для Wi-Fi и Ethernet-кабель для подключения к роботу. Либо использовать USB-адаптер в качестве второго адаптера. В любом случае может потребоваться настройка сетевой маршрутизации устройства.

Запись NetworkTables в NDJSON (офлайн)

CLI-инструмент nt-recorder подключается к работающему серверу NT4 и записывает события значений в файл .ndjson с временными метками. Он запускается на компьютере разработчика и читает данные из симуляции или робота; изменения на стороне робота не требуются.

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

Параметры:

• --prefixes — префиксы тем для подписки (по умолчанию: /)

• --output-dir — каталог для выходных файлов (по умолчанию: ./recordings)

• --duration — записывать в течение N секунд, затем завершить работу (по умолчанию: до нажатия Ctrl+C)

• --team — подключиться по номеру команды вместо IP/порта сервера

• --server-ip / --server-port — адрес сервера NT4 (по умолчанию: 127.0.0.1:5810)

• --identity — строка идентификации клиента (по умолчанию: nt-recorder)

• --quiet — подавить вывод статуса в stderr

Выходные файлы называются nt-record-<ГГГГ-ММ-ДДTЧЧ-ММ-СС>.ndjson (без двоеточий, совместимо с Windows). Каждая строка — {"time": float, "topic": str, "value": jsonable}. Коды завершения: 0 — успешно, 1 — ошибка подключения, 2 — ошибка диска/ввода-вывода.

Инструменты

Сервер предоставляет 17 инструментов (13 для работы в реальном времени + 4 для офлайн-анализа). Каждый ответ инструмента реального времени включает флаг connected.

Инструменты реального времени

Офлайн-инструменты для записей

Офлайн-инструменты читают данные из каталога, заданного переменной окружения NT_RECORDINGS_DIR (по умолчанию ./recordings). Записи хранятся только локально — рекордер запускается на компьютере разработчика и читает NT из симуляции или робота; изменения на стороне робота не требуются.

Регистрация в любом агенте

Сервер — это пакет, запускаемый через uvx из git-репозитория, поэтому любой MCP-клиент может запустить его без локальной копии или предустановленного виртуального окружения. Запуск по требованию:

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

Или установите консольный скрипт один раз и запускайте где угодно:

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

Добавьте эту запись в конфигурацию MCP вашего агента (здесь показано для opencode в файле opencode.jsonc на уровне проекта):

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

Проверьте с помощью opencode mcp list из корня проекта: сервер nt должен отображаться как подключённый.

Разработка

• Виртуальное окружение Python 3.14.0 в .venv; зависимости установлены из requirements.txt (fastmcp==3.4.7, pyntcore==2026.2.2).

• Тесты: uv run pytest tests/ -v

Лицензия

Этот проект распространяется под лицензией MIT.