内容
">
<img src="docs/assets/banner.jpg" alt="机工具包 by Robotto" width="100%" />
</p>
# AI无人机工具包
MCP服务器和工具，用于智能无人机开发（PX4及更多）。该工具包为AI助手（Cursor、Claude等）提供结构化的工具，以理解、调试和推理无人机系统 — 从PX4飞行日志和仅限仿真的PX4 SITL命令开始。
这是一个[uv](https://docs.astral.sh/uv/)工作区monorepo：共享逻辑存在于核心包中，每个工具都是在其之上的一个薄而独立的可用层。
## 仓库布局
| 路径 | 描述 |
|------|-------------|
| [`packages/robotto-drone-core`](packages/robotto-drone-core) | 共享的、与MCP无关的解析器、安全检查和坐标系实用程序。 |
| [`tools/px4-ulcp`](tools/px4-ulog-mcp) | 用于检查PXLog（`.ulg`）飞行日志的MCP服务器。 |
| [`tools/px4-sitl-mcp`](px4-sitl-mcp 仅限仿真的MCP服务器，用于带有安全检查的 SITL命令。 |
| [`docs/`](docs) | 项目范围。 |
| [`examples/`](examples) | 可运行的示例。 |
## 入门指南
需要Python 3.12+和https://docs.astral.sh/uv/)。
```bash
git clone https://github.com/robotto-xyz/ai-drone-toolkit.git ai-drone-toolkit
uv sync --all-packages
```
这工作区设置了一个虚拟环境。从那里任何成员，例如运行PX4 ULog MCP服务器或PX4 SITL命令服务器：
```bash
px4-ulog-mcp
uv run px4-sitl-mcp
```
## 示例
可运行的脚本位于[`examples/`](examples，直接驱动共享核心包或工具层：
# 总结飞行日志（默认为PX4示例固定装置uv run python examples/analyze_ulog.py /absolute/path/to/flulg
# 标记警告/错误和飞行模式时间线：
uv run python examples/flight.py/path/to/flight.ulg
# 需要运行的PXL实例：
uv run python examples_connect_state.py
uv run python examples/sitl_fly_survey.py
```
参见[`examples/README.md`](examples/README.md)了解详情。
## 文档
- [`docs/`](docs) — 架构和项目范围内的指南。
- [`packages/robotto-drone-core/README.md`](packages/robotto-drone-core/README.md)
— 共享解析、安全和帧转换API。
- [`tools/px4-ulog-mcp/README.md`](tools/px4-ulog-mcp/README.md) — 安装、
连接到您的编辑器并分析飞行日志。
- [`tools/px4-sitl-mcp/README.md`](tools/px4-sitl-mcp/README.md) — 连接到
PX4 SITL，检查状态并发出仅限仿真的命令。
## 许可证
MIT。
