nt-mcp-server

FRC NetworkTables データの読み取り、書き込み、監視を行うスタンドアロン MCP サーバーです。AI エージェントが NetworkTables プロトコルを介してロボットのネットワークテーブルと通信できるようにします。主な対象はローカルの RobotPy シミュレーション（127.0.0.1:5810 上の python -m robotpy sim）です。

依存関係は固定されています（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 に接続

サーバーが有用なデータを読み書きできるようにするには、シミュレーションを先に起動しておく必要があります。シミュレーション専用のプロジェクトと venv から起動します:

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

サーバーはデフォルトで 127.0.0.1:5810 に接続します。これはシミュレーションが待ち受けているアドレスです。

実機ロボットの NetworkTables に接続

ほとんどの場合、NetworkTables を記録し、MCP を使用して記録を分析するだけで十分です。

実機ロボットの NetworkTables にリアルタイムで接続する場合は、デバイスに 2 つのネットワークアダプターが必要です。1 つはインターネット用、もう 1 つはロボット通信用です。1 つの方法としては、ワイヤレスアダプターで Wi-Fi に接続し、イーサネットケーブルでロボットに接続します。あるいは、USB ネットワークアダプターを 2 つ目のアダプターとして使用します。どちらの場合も、デバイスのネットワークルーティングを設定する必要があるかもしれません。

NetworkTables を NDJSON に記録（オフライン）

nt-recorder CLI はライブの NT4 サーバーに接続し、値のイベントをタイムスタンプ付きの .ndjson ファイルに書き込みます。開発用ラップトップで実行し、シミュレーションまたはロボットから NT を読み取ります。ロボット側の変更は不要です。

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-<YYYY-MM-DDTHHMMSSZ>.ndjson という名前になります（コロンなし、Windows 対応）。各行は {"time": float, "topic": str, "value": jsonable} です。終了コード: 0 正常終了、1 接続失敗、2 ディスク/IO エラー。

ツール

サーバーは 17 個のツール（ライブ 13 個 + オフライン 4 個）を公開します。すべてのライブツールの応答には connected フラグが含まれます。

ライブツール

オフライン記録ツール

オフラインツールは、NT_RECORDINGS_DIR 環境変数（デフォルト: ./recordings）で設定されたディレクトリから読み取ります。記録はローカルのみです。レコーダーは開発用ラップトップで実行され、シミュレーション/ロボットから NT を読み取ります。ロボット側の変更は不要です。

任意のエージェントに登録

このサーバーは git から実行可能な uvx パッケージであるため、任意の MCP クライアントがローカルチェックアウトや事前構築済みの venv なしで起動できます。必要に応じて実行します:

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 サーバーが接続済みとして表示されるはずです。

開発

• .venv 内の Python 3.14.0 venv。依存関係は requirements.txt からインストール（fastmcp==3.4.7、pyntcore==2026.2.2）。

• テスト: uv run pytest tests/ -v

ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。