ginimageApi/docs/mcp-tools/MCP_UYGULAMA_PLANI.md

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