# 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.
- Tür: Open-Source
- Olgunluk: Alpha
- Durum: Geliştiriliyor
- Odak: AI ve AI destekli geliştirme
- Başlangıç: 2026-09-16
- Teknolojiler: TypeScript, Node.js, MCP, YAML, OTLP
- Etiketler: #ai, #mcp, #guvenlik, #prompt-injection, #pii
- Kaynak kodu: https://github.com/Tunedness/McpGuard
- Kaynak: https://muhammetsafak.com/tr/labs/mcpguard-lab/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
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](https://muhammetsafak.com/tr/labs/agentfuse-lab/) ile zincirlenebiliyor: McpGuard en dışta durup oturum kimliğini ekliyor, AgentFuse onu benimsiyor.
