Files
ginimageApi/docs/mcp-tools/MCP_UYGULAMA_PLANI.md
Beyhan Oğur e04ba85564 first commit
2026-04-26 21:40:14 +03:00

75 lines
1.8 KiB
Markdown

# MCP Uygulama Plani (Kod Gelistirme Odakli)
Bu planin hedefi:
- MCP'yi once MD tabanli ve guvenli sekilde calisir hale getirmek
- Sonra kod gelistirmeyi hizlandiran tool'lara gecmek
## Faz 1 - MD tabanli temel (1-2 gun)
1. Hedefi sabitle
- Ilk hedef: endpoint degisikligi oncesi etki analizi ve test plani bilgisi almak.
2. Tool spec dosyalarini olustur
- docs/mcp-tools/codebase_map.md
- docs/mcp-tools/endpoint_contract_find.md
- docs/mcp-tools/test_plan_suggest.md
3. MCP servere iki read-only tool ekle
- md_guide_list
- md_guide_get
4. Guvenlik sinirlari
- Sadece docs/mcp-tools klasoru okunur
- Sadece .md dosyalari listelenir/okunur
- Path traversal engeli uygulanir
- Maksimum dosya boyutu limiti uygulanir
5. Dogrulama
- tools/list icinde yeni 2 tool gorunmeli
- md_guide_list en az 3 dosya donmeli
- md_guide_get secilen dosyayi okumali
## Faz 2 - Kod zeka tool'lari (2-4 gun)
1. codebase_map runtime
- Proje klasor agacini ozetler
- Kritik dosyalari vurgular
2. endpoint_contract_find runtime
- method + path ile handler/model/response baglarini bulur
3. test_plan_suggest runtime
- Hedef endpoint/dosya icin test checklisti dondurur
## Faz 3 - Kalite ve olcekleme (1-2 gun)
1. Standart hata modeli
- invalid params
- not found
- internal error
2. Gozlemlenebilirlik
- tool cagrisi sayisi
- basari/hata orani
- yanit suresi
3. Operasyon notlari
- README'de hizli kullanim
- Swagger'da endpoint gorunurlugu
## Bu hafta icin net gorev listesi
1. Plan dosyasi hazir
2. 3 MD spec dosyasi hazir
3. md_guide_list implement
4. md_guide_get implement
5. MCP paket testleri
6. README ornekleri
## Hazirlik tamam olma kriteri
- MCP tools/list cagrisi yeni tool'lari donduruyor
- md_guide_get ile secilen rehber metni geliyor
- Invalid guide adinda temiz hata donuyor
- Kod derleniyor ve testler geciyor