first commit

docs/mcp-tools/MCP_UYGULAMA_PLANI.md

@@ -0,0 +1,74 @@
+# 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