JSON-RPC 2.0 over stdio · --allow-root sandbox

Local-first drone footage tools for AI agents.

Start a stdio Model Context Protocol server confined to explicitly allowed footage directories so AI assistants can search your flights, inspect telemetry and keyframes, export NLE markers, and render map overlays without raw video leaving disk.

npx drone-path mcp --allow-root /path/to/footage

Documentation in progress: Client configuration snippets, security boundary details, and the complete 9-tool reference table are staged in the content draft branch.

Safety & tool surface

Designed for safe local automation

Strict root confinement

Requires --allow-root, validates canonical realpath boundaries against symlinks and traversal, protects the SQLite archive files, and refuses file overwrites by default.

Nine structured tools

Covers archive scanning, clip and flight queries, point-in-gaze lookups, kinematic shot listing, per-clip telemetry inspection, keyframe extraction, marker export, and bounded map rendering.