ardupilot-mcp

ardupilot-mcp

🇹🇷 Türkçe · 🇬🇧 English

Drone'un mu düştü ya da kötü mü uçtu? ArduPilot uçuş kontrolcüsü her uçuşta bir kara-kutu dosyası tutar — .bin uçuş logu. Bu araç o dosyayı okur ve bir yapay zekâ sohbet uygulamasının uçuşta ne olduğunu düz dille anlatmasını sağlar: düşük batarya, aşırı titreşim, GPS kaybı, kablo arızası, kötü ayar… Tahminle değil, deterministik bir kontrol motoruyla.

Nasıl bir şey bu? Kendi penceresi/uygulaması yok. Bir yapay zekâ sohbet uygulamasına takılır — Claude Desktop, Cursor, VS Code gibi (bunlara "MCP istemcisi" denir). Önce o uygulamalardan birini kurarsın, bu aracı ona eklersin, sonra düz dille sorarsın. (MCP = Model Context Protocol; bu uygulamaların araçlarla konuştuğu standart "fiş".)

Neden bunu kullanayım?

Mission Planner'ın Auto Analysis'i ve UAV Log Viewer zaten var ve iyiler — ama farklı bir iş yapıyorlar. Kısaca: o araçlar veriyi gösterir, yorumu sen yaparsın; bu araç veriyi yorumlar, düz dille anlatır ve sorularını cevaplar.

	MP Auto Analysis	UAV Log Viewer	ardupilot-mcp
Çıktı	sabit geç/kal listesi	grafik + 3B uçuş tekrarı	düz dille açıklama + sohbet
"Neden düştü?" diye sorup gerekçeli cevap	—	—	✓
Doğal dille takip sorusu ("15–30 sn titreşim?")	—	—	✓
Konfig/kurulum hataları (param denetimi, kalibrasyon, kablo, pre-arm)	kısmen	—	✓
Fiziksel muhakeme (güç marjı, itki/ağırlık)	—	—	✓
Her bulguda resmi ArduPilot doküman linki	—	—	✓
Grafik / 3B harita görselleştirme	—	✓	—
Anında, kurulum yok	✓ (MP'de hazır)	✓ (web)	AI istemcisi + uv gerekir

Diğerlerini ne zaman kullan: bir sinyali grafikte görmek veya uçuş yolunu 3B izlemek için → UAV Log Viewer. Elinde Mission Planner açıkken hızlı bir geç/kal için → MP Auto Analysis. Bu araç onların yerini almaz; "neden böyle oldu?"yu açıklaması ve takip sorularını cevaplaması, kararı deterministik bir motora + resmi dokümana dayandırması, ve uçuş sinyallerinin yanı sıra konfig/kurulum ve fiziksel tarafı da kapsaması için var. Ayrıca tamamen offline ve salt-okunur çalışır.

Hızlı başlangıç (5 dakika)

En kısa yol — Claude Desktop ile:

1. Claude Desktop'ı kur: https://claude.ai/download
2. uv'yi kur — bu aracı senin yerine indirip çalıştıran küçük, ücretsiz bir program (uvx onunla gelir):
   • Windows (PowerShell): powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
   • macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
   • Dokümanı: https://docs.astral.sh/uv/getting-started/installation/ · Çalıştı mı: uv --version bir sürüm yazmalı.
3. Claude Desktop'ta Settings → Developer → Edit Config; şunu yapıştır ve kaydet:

   { "mcpServers": { "ardupilot-mcp": { "command": "uvx", "args": ["ardupilot-mcp"] } } }
   

   Sonra Claude Desktop'ı tamamen kapatıp yeniden aç — pencereyi kapatmak yetmez; sistem tepsisinden de çık.
4. Bir .bin logu edin (aşağıdaki Uçuş logunu nereden bulurum?). Elinde yoksa AI istemcisi olmadan dene ile demo üret.
5. Sohbet kutusuna yaz: "C:\loglar\ucus.bin logunu analiz et — neden düştü?" (yolu kendi dosyanla değiştir).

uv yerine pip kullanmak ya da başka bir uygulama (Cursor, VS Code, Cline, LM Studio…) eklemek için → İstemcine ekle.

Uçuş logunu (.bin) nereden bulurum?

Uçuş kontrolcün her uçuş için bir .bin DataFlash logu kaydeder. Bilgisayarına almak için:

• En kolayı — Mission Planner: USB ile bağlan → Flight Data → DataFlash Logs → Download DataFlash Log Via Mavlink → uçuşu seç → kaydet (ör. C:\loglar\). QGroundControl da olur.
• Ya da SD karttan: kontrolcünün SD kartında genelde APM/LOGS veya /LOGS klasörü; dosya adı 00000042.BIN gibi görünür.

Tam dosya yolunu not et — yapay zekâya vereceğin şey o. Detay: ArduPilot — Downloading and Analyzing Data Logs.

AI istemcisi olmadan dene

Bir AI uygulaması kurmadan, motorun çalıştığını görmek istersen kaynağı indir (örnek scriptler pip paketinde gelmez, repoyu klonlaman gerekir):