McpGuard
AI ajanınız ile araçları arasındaki güvenlik katmanı.
Marka: Tunedness
McpGuard, bir AI istemcisi ile onun kullandığı MCP sunucuları arasına giren bir güvenlik proxy’sidir. Ajanlarınızın araç çağrıları ve araç yanıtları bu katmandan geçer; McpGuard onları tarar, maskeler, kurala bağlar ve kaydeder. Tunedness’ın açık kaynak projelerinden biridir.
Ne yapar
Injection taraması. Deterministik bir motor kural imzalarını, emir kipini, gizli Unicode karakterlerini ve kodlanmış yükleri (çözülüp yeniden taranır) arar; ayrıca dışarı veri sızdıran işaretçileri ve sohbet çerçevesi enjeksiyonlarını yakalar. Türkçe ve İngilizce desteklenir; deasciified yazıma ve homoglyph’lere dayanıklıdır.
PII maskeleme. TC kimlik no, vergi no, IBAN, kart numarası (sağlama toplamı kontrollü), telefon ve e-posta [KIND:***] biçiminde maskelenir.
Erişim kontrolü. Araç bazında izin ver ya da engelle, roller ve tehlikeli yetenek kombinasyonları tanımlanır.
Manifest sabitleme. Bir sunucunun araç tanımı ilk kullanımda güvenilir kabul edilir ve hash ile kilitlenir; sonradan değişirse (rug-pull) fark edilir.
Denetim kaydı. Hash zincirli JSONL kaydı kurcalamayı engellemez, kurcalandığını belli eder (tamper-evident); ham içerik yerine maskeli içerik ve anahtarlı parmak izi saklanır.
Gözlemle, sonra uygula
init komutu gözlem modunda bir başlangıç politikası (guardpolicy.yaml) üretir. wrap bir MCP sunucusunu sarar, scan bir dosyayı tarar, audit verify denetim kaydının bütünlüğünü doğrular. Telemetri (OTLP) isteğe bağlıdır ve varsayılan olarak kapalıdır. McpGuard, aynı organizasyonun AgentFuse projesiyle zincirlenebilir; zincirde en dıştaki proxy olur.
Kurulum ve kapsam
McpGuard GitHub deposundan kurulur: depoyu klonlayıp derlersiniz. Henüz npm’de yayınlanmış paketi yoktur. Node.js 20.19 ya da üzeri gerekir. Bilerek kapsam dışı bırakılanlar: korumalı HTTP geçidi, sağlık verisi (PHI) maskeleme ve yerel SLM yargıcı; bunlar sonraya planlanmıştır.
Lisans
Apache-2.0. Kaynak kodu GitHub üzerinde geliştirilir.
Öne çıkan özellikler
- Prompt injection taraması: kural imzaları, gizli Unicode, kodlanmış yükler, Türkçe ve İngilizce
- PII maskeleme: TC kimlik no, vergi no, IBAN, kart, telefon, e-posta
- Araç bazında izin ver/engelle kuralları ve rol tabanlı erişim
- Manifest sabitleme: ilk kullanımda güven, hash kilidi, rug-pull tespiti
- Hash zincirli denetim kaydı: kurcalama belli olur (tamper-evident)
- Başlangıç politikası hiçbir şeyi engellemez; PII maskelenir, kayıt açıktır
Sıkça sorulan sorular
McpGuard ne yapıyor?+
AI istemcisi ile MCP sunucuları arasına oturan bir güvenlik proxy'sidir. Geçen trafiği prompt injection açısından tarar, kişisel verileri maskeler, araç erişimini kısıtlar ve olanları denetim kaydına yazar.
Nasıl kuruluyor?+
McpGuard GitHub deposundan kurulur: depo klonlanır, derlenir ve komut satırı aracı yerel olarak çalıştırılır. Henüz npm'de yayınlanmış bir paketi yoktur.
Hemen bir şeyleri engellemeye başlar mı?+
Hayır. Başlangıç politikası gözlem modundadır: hiçbir şey engellenmez, kişisel veriler maskelenir ve denetim kaydı açıktır. Engellemeyi siz açarsınız.
Denetim kaydı ham içeriği saklar mı?+
Hayır. Kayıt hash zincirli bir JSONL dosyasıdır ve ham içerik yerine maskelenmiş içerik ile anahtarlı bir parmak izi tutar.
Telemetri gönderiyor mu?+
Telemetri isteğe bağlıdır ve varsayılan olarak kapalıdır.
Lisansı nedir?+
Apache-2.0. Açık kaynaktır; kaynak kodu GitHub'dadır.
Bir sonraki projenizi birlikte kuralım
Fikrinizi anlatın, size en uygun çözümü tasarlayalım.
İletişime geç