MCP — Açık Erişim

ilk72 v0.1.0 protokol 2024-11-05 51 çağrı işlendi

MCP (Model Context Protocol), bir yapay zekâ asistanının dış bir veri kaynağına bağlanmasını sağlayan açık standarttır. İLK72'nin afet veri omurgası bu protokolle dışarıya açıktır: bir STK, belediye ya da gönüllü grup kendi Claude'una bu sunucuyu ekleyip "Bağcılar'da hangi ihtiyaçlar karşılanmadı?" diye sorabilir, sahadan topladığı veriyi de aynı yerden sisteme yazabilir.

Afet verisi tek kurumun tekelinde olmamalı. Bu yüzden okuma araçları API anahtarı istemez — anahtar verirseniz çağrılarınız kurumunuz adına loglanır, vermezseniz de veri açıktır. Kişisel veri (hane kaydı) KVKK gereği maskelenerek döner.

İLK72 bir uygulama değil, bir afet işletim sistemi: insanlar panelleri kullanır, makineler ve yapay zekâ ajanları MCP'yi kullanır. Aşağıdaki iki senaryo tam olarak bunun için var.

İki gerçek ajan senaryosu

Bunlar temsili değil — aşağıdaki çağrılar bu sunucuda birebir çalışır.

Senaryo 1 — Saha ajanı

"Antakya'nın kuzeyinde jeneratör ihtiyacı olan ama henüz jeneratör gönderilmemiş noktaları getir."

{"method":"tools/call","params":{
  "name":"ihtiyac_ozet",
  "arguments":{
    "yon":"ihtiyac",
    "kalem":"jeneratör",
    "ilce":"Antakya",
    "sadece_karsilanmamis":true }}}

sadece_karsilanmamis = durumu hâlâ acik VE hiçbir arzla eşleşmemiş kayıtlar. Yani "oraya henüz kimse bir şey göndermedi". Dönen her nokta lat/lon, miktar, birim ve aciliyetle gelir.

Senaryo 2 — Lojistik ajanı

"Ankara'dan 20 jeneratörümüz var, optimum dağıt."

1) ihtiyac_ozet(yon="ihtiyac", kalem="jeneratör",
                sadece_karsilanmamis=true)
   → karşılanmamış noktalar + koordinat + aciliyet

2) yol_durumu(ilce="...")
   → hangi rota kapalı, bilgi kaç saatlik

3) kayit_ekle(kaynak="stk", ham_metin="20 jeneratör
   Ankara'dan yola çıktı, dağıtım: ...")
   → planı omurgaya geri yaz

4) olay_guncelle(kume_id=..., durum="ekip_atandi")

Ajan okuma + yazma döngüsünü tek sunucudan kapatır. Yazdığı plan başka ajanlar için anında görünür olur.

Veri bayatlar — her yanıt bunu söyler

Saat 09:00'da "yol kapalı" olan bilgi 13:00'te yanlış olabilir. Bir ajanın kaç saattir doğrulanmamış veriye baktığını bilmesi gerekir. Bu yüzden her okuma aracının döndürdüğü her satırda şu alanlar var:

son_dogrulama

Verinin son teyit edildiği damga.

yas_saat

O günden bu yana geçen saat.

tazelik

taze (≤3sa) · eskimeye_basladi (≤12sa) · bayat (>12sa)

guven

0-100. Kümede çok kaynaklı doğrulamayla artar.

yol_durumu ayrıca zaman-geçerli kayıt tutar: varsayılan olarak yalnızca hâlâ geçerli satırlar döner, gecmis_dahil=true ile "09:00 kapalı → 13:00 açıldı" izini sürebilirsiniz.

Uç nokta

Adres

https://afetnet.spatly.io/mcp/rpc

Taşıma

JSON-RPC 2.0 / HTTP POST

Kimlik

Bearer <api_anahtari> (opsiyonel)

Canlı deneme tezgâhı

Kurulum yapmadan deneyin: aşağıdaki istek gerçekten POST /mcp/rpc adresine gider, yanıt bu sayfada görünür ve çağrı aşağıdaki kullanım kaydına düşer.

Araç Argümanlar (JSON)

Hazır.

Sunucu yanıtı

Henüz çağrı yapılmadı.

Araçlar

11 araç. Açıklamalar LLM'in hangi soruda hangi aracı seçeceğini anlaması için yazıldı.

kayit_ekle YAZMA

Sahadan gelen HAM bir ihbarı/bilgiyi İLK72 omurgasına yazar. STK, gönüllü grup, telsiz operatörü ya da vatandaş elindeki bilgiyi buraya girer. Metni olduğu gibi gönder — normalize etmeye çalışma, sistemin LLM triyajı kategoriyi, ilçeyi, aciliyeti çıkarır ve mükerrerse mevcut olay kümesine bağlar. KULLAN: kullanıcı 'şunu sisteme gir / şu ihbarı ilet / elimde şu bilgi var' dediğinde.

Parametre	Tip	Zorunlu	Açıklama
`kaynak`	string	evet	Bilginin geldiği kanal. stk=sivil toplum kuruluşu, telsiz=amatör telsiz, saha_ekibi=arama kurtarma/AFAD ekibi, vatandas=doğrudan vatandaş, twitter=sosyal medya. stk \| telsiz \| saha_ekibi \| vatandas \| twitter \| cagri_merkezi \| mcp
`ham_metin`	string	evet	İhbarın ham metni. Adres, kişi sayısı, ihtiyaç ne varsa olduğu gibi yaz. Kısaltma/özetleme yapma.
`kaynak_ref`	string	hayır	İsteğe bağlı iz kaydı: tweet id, telsiz frekans/saat, STK kayıt numarası. API anahtarıyla gelindiyse otomatik doldurulur.