@guardbee/mcp-security-proxy 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +108 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# @guardbee/mcp-security-proxy
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@guardbee/mcp-security-proxy)
|
|
4
|
+
[](https://www.npmjs.com/package/@guardbee/mcp-security-proxy)
|
|
5
|
+
[](LICENSE)
|
|
6
|
+
|
|
7
|
+
Herhangi bir MCP sunucusunun önüne oturan şeffaf güvenlik katmanı. Prompt injection saldırılarını engeller, yanıtlardaki PII'yi maskeler ve her isteği değiştirilemez audit log'a yazar.
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
Claude ──► MCP Security Proxy ──► Herhangi bir MCP Sunucu
|
|
11
|
+
│
|
|
12
|
+
├─ Prompt injection tespiti (16 saldırı deseni)
|
|
13
|
+
├─ PII maskeleme (TC kimlik, IBAN, e-posta, JWT, API key)
|
|
14
|
+
├─ Block veya warn modu
|
|
15
|
+
└─ Yapılandırılabilir audit log
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Özellikler
|
|
21
|
+
|
|
22
|
+
- **Prompt Injection Koruması** — 16 saldırı deseni ile sistem prompt'larını geçersiz kılmaya çalışan istekler engellenir
|
|
23
|
+
- **PII Maskeleme** — TC kimlik no, IBAN, e-posta, telefon, JWT token, API key yanıtlarda otomatik maskelenir
|
|
24
|
+
- **Block / Warn Modu** — Her interceptor bağımsız olarak engelleyici veya uyarı modunda çalışabilir
|
|
25
|
+
- **Audit Log** — Console veya dosyaya yazılan yapılandırılabilir log
|
|
26
|
+
- **Sıfır Kod Değişikliği** — Mevcut herhangi bir MCP sunucusunun önüne takılır
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Hızlı Başlangıç
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
npm install -g @guardbee/mcp-security-proxy
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
`claude_desktop_config.json` dosyasına ekleyin:
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
{
|
|
40
|
+
"mcpServers": {
|
|
41
|
+
"secure-filesystem": {
|
|
42
|
+
"command": "npx",
|
|
43
|
+
"args": [
|
|
44
|
+
"-y", "@guardbee/mcp-security-proxy",
|
|
45
|
+
"--", "npx", "-y",
|
|
46
|
+
"@modelcontextprotocol/server-filesystem", "/tmp"
|
|
47
|
+
]
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
> Proxy, `--` sonrasındaki komutu hedef MCP sunucu olarak başlatır.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## MCP Tools
|
|
58
|
+
|
|
59
|
+
Proxy, tool'ları hedef sunucudan şeffaf olarak aktarır ve her geçişte interceptor zincirini uygular. Ek olarak aşağıdaki yönetim tool'unu sunar:
|
|
60
|
+
|
|
61
|
+
| Tool | Açıklama |
|
|
62
|
+
|------|----------|
|
|
63
|
+
| `proxy_status` | Aktif interceptor'ları ve son engellenen istek istatistiklerini gösterir |
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Interceptor'lar
|
|
68
|
+
|
|
69
|
+
### Prompt Injection Detector
|
|
70
|
+
|
|
71
|
+
Gelen mesajlarda aşağıdaki saldırı desenlerini arar:
|
|
72
|
+
|
|
73
|
+
- `ignore previous instructions`
|
|
74
|
+
- `disregard your system prompt`
|
|
75
|
+
- `you are now [DAN/jailbreak]`
|
|
76
|
+
- ANSI escape dizileri ile gizlenmiş komutlar
|
|
77
|
+
- Base64 kodlanmış talimatlar
|
|
78
|
+
- ve 11 desen daha
|
|
79
|
+
|
|
80
|
+
### PII Masker
|
|
81
|
+
|
|
82
|
+
| Veri Tipi | Örnek Girdi | Çıktı |
|
|
83
|
+
|-----------|------------|-------|
|
|
84
|
+
| TC Kimlik | `12345678901` | `[TC-REDACTED]` |
|
|
85
|
+
| IBAN | `TR320006200...` | `TR32***` |
|
|
86
|
+
| E-posta | `ahmet@example.com` | `ah***@example.com` |
|
|
87
|
+
| JWT | `eyJhbGc...` | `[JWT-REDACTED]` |
|
|
88
|
+
| API Key | `sk-abc123...` | `[KEY-REDACTED]` |
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Yapılandırma
|
|
93
|
+
|
|
94
|
+
Ortam değişkenleri ile yapılandırılabilir:
|
|
95
|
+
|
|
96
|
+
| Değişken | Varsayılan | Açıklama |
|
|
97
|
+
|----------|-----------|----------|
|
|
98
|
+
| `PROXY_MODE` | `block` | `block` veya `warn` |
|
|
99
|
+
| `PROXY_LOG` | `console` | `console` veya `file` |
|
|
100
|
+
| `PROXY_LOG_PATH` | `./proxy-audit.jsonl` | Log dosya yolu |
|
|
101
|
+
| `PROXY_PII_MASK` | `true` | PII maskelemeyi etkinleştir |
|
|
102
|
+
| `PROXY_INJECTION_CHECK` | `true` | Injection kontrolünü etkinleştir |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Lisans
|
|
107
|
+
|
|
108
|
+
MIT — [GuardBee](https://guardbee.ai)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guardbee/mcp-security-proxy",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Security proxy for MCP servers — intercepts tool calls, detects prompt injection, masks PII, and writes audit logs",
|
|
5
5
|
"author": "GuardBee <hello@guardbee.ai>",
|
|
6
6
|
"license": "MIT",
|