McpGuard: MCP trafiğine kural tabanlı güvenlik proxy'si
Ajan ile MCP sunucuları arasında araç sonuçlarını injection için tarayan, PII'yi maskeleyen, erişimi denetleyen ve kararları zincirli log'a yazan proxy.
Şu an ne yapıyor
Ajan ile MCP sunucusu arasına stdio (`wrap`) ya da HTTP (`serve`) üzerinden oturup araç sonuçlarını ve resource içeriklerini prompt injection için tarıyor, kişisel veriyi maskeliyor, araç, rol ve tehlikeli yetki birleşimi bazında erişimi denetliyor, sunucunun araç tanımlarını kilitliyor ve her kararı hash zincirli bir audit log'a yazıyor. MCP sunucularını ajanlarına bağlayan geliştirici depoyu klonlayıp derleyerek deneyebilir; npm'de yayımlı değil.
- Başlangıç
- Eylül 2026 — Devam ediyor
Tür
Teknolojiler
McpGuard’ın injection taraması 700 öğelik corpus’umda %100 yakalıyor, yanlış pozitif %0,0. Bu rakamı bir tavan olarak okuyorum: corpus da kural seti de aynı elden çıktı. Rakamın ne dediği ve ne demediği bu kaydın asıl konusu.
Ajanla MCP sunucusunun arasındaki denetim noktası
McpGuard, MCP istemcisiyle sunucuları arasına giren bir güvenlik proxy’si. İstemcide ya da sunucuda kod değişmiyor; sunucunun komutunun yerine wrap (stdio) ya da serve (HTTP) yazılıyor. Proxy araç sonuçlarını ve resource içeriklerini tarıyor, kişisel veriyi maskeliyor ve araç bazında allow / deny kuralları uyguluyor. Roller çağıranın kimliğinden eşleniyor; servers.<ad>.roles bir sunucuya kimin erişebileceğini belirliyor, “dosya oku” ile “ağa çık” gibi tehlikeli yetki birleşimleri de her çağrıda uygulanan kurallar. Sunucuların araç tanımları ilk bağlantıda guardlock.json’a hash’leniyor; sonraki oturumda liste uyuşmazsa tools/list ve tools/call reddediliyor ve bu durma lock --accept ya da yeniden başlatma olmadan kalkmıyor. Her karar hash zincirli bir JSONL audit log’a düşüyor; log’da maskelenmiş içerik ve ham içeriğin anahtarlı parmak izi var, ham içeriğin kendisi yok. serve her sunucuyu /mcp/<ad> altında kendi kuralı, kilit girişi ve bağlantı havuzuyla sunuyor; varsayılanı loopback, loopback dışında auth.tokens ve http.allowed_hosts olmadan açılmıyor ve TLS yok, düz HTTP.
Başlangıç politikası gözlem modunda (mode: flag): her karar hesaplanıp kaydediliyor, hiçbir şey engellenmiyor. Önce kendi trafiğinizi ölçüyor, sonra enforce’a geçiyorsunuz.
Tarama deterministik ve kapalı bir listeyle sınırlı
Birinci kademe bir model kullanmıyor: imza kuralları, emir kipi, gizli Unicode, çözülüp yeniden taranan kodlanmış yükler, dışarı sinyal gönderen yapılar ve sohbet çerçevesi enjeksiyonu Türkçe ve İngilizce kurallarla aranıyor. Skor tam sayı üzerinden hesaplanıyor; aynı girdi her platformda bayt-birebir aynı kararı veriyor. PII tarafında TC kimlik no, vergi no, IBAN, kart (kontrol hanesiyle), telefon ve e-posta maskeleniyor; pii.profile: health isteğe bağlı olarak kurum referans numaralarını, klinik tarihleri, ilaç kutusu seri numaralarını ve ABD SSN/Medicare kimliklerini ekliyor. İsim ve adres tanınmıyor.
Taranan yüzey üç kapı: tools/call, resources/read ve tools/list. prompts/get, sampling/createMessage ve elicitation bilerek taranmıyor.
%100 neyi söylüyor
Corpus 700 etiketli öğe: 12 saldırı ailesinde 300 pozitif, 400 negatif. Kural seti ve corpus aynı kaynaklardan çıktı; holdout ayrımı çalışma noktasını ayırıyor, kuralları değil. Yani %100, “corpus’un içerdiği her saldırı ailesini ruleset 0.1.0’da yakaladım” demek; kimsenin kural yazmadığı bir ifadeye karşı ne olacağını bilmiyorum. Parafraz boşluğunu bir kural motoru kapatamaz; cevap olarak kapalı gelen bir ikinci kademe yazdım: kendi çalıştırdığınız yerel bir model yalnız karar yükseltebiliyor, hiç düşüremiyor. Benim makinemde Ollama üzerinde gemma4:12b ile 64 parafraz injection’ın 61’ini, 60 benign öğenin 0’ını injection saydı; bu bir model, küçük bir küme, oran değil. Üstelik varsayılan bant bu 64 parafrazın hiçbirini hakeme göndermiyor: hepsi kural motorunda flag_at eşiğinin altında kalıyor, 57’si tam 0 puan alıyor. Hepsini göndermek band_from: 0 ile açılan bir tercih.
Gecikmede referans iş yükü küçük sonuçlar: corpus medyanı 188 bayt, 1 KB’ta p95 0,23–0,27 ms. 32 KB’a kadar p95 her koşuda 20 ms altında kaldı; üstünde makineye bağlı, 128 KB’ta üç koşuda p95 32,5 ile 202 ms arasında çıktı.
main’de bugün: v0.2.0 hazırlanıyor
Alpha. Anlattıklarımın hepsi GitHub’daki main’de; npm’de yayımlı bir şey yok, denemek için klonlayıp npm install && npm run build yapıp node packages/cli/dist/main.js ile çalıştırıyorsunuz. v0.2.0’ı topluyorum: dokümanlar review’da, tarball’larla uçtan uca kabul senaryosu ve plan sonu güvenlik incelemesi sırada.
McpGuard, AgentFuse ile zincirlenebiliyor: McpGuard en dışta durup oturum kimliğini ekliyor, AgentFuse onu benimsiyor.