@guardbee/mcp-secret-scanner 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 +99 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# @guardbee/mcp-secret-scanner
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@guardbee/mcp-secret-scanner)
|
|
4
|
+
[](https://www.npmjs.com/package/@guardbee/mcp-secret-scanner)
|
|
5
|
+
[](LICENSE)
|
|
6
|
+
|
|
7
|
+
Kaynak dosyalarınızı, dizinleri ve ortam konfigürasyonlarını açık API key, parola, token ve diğer gizli bilgiler açısından tarayan MCP sunucusu. Claude'a doğrudan projenizden secret sızdırıp sızdırmadığınızı sorabilirsiniz.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Özellikler
|
|
12
|
+
|
|
13
|
+
- **40+ Secret Deseni** — AWS, GitHub, GitLab, Stripe, OpenAI, Anthropic, HuggingFace, Slack, Twilio, SendGrid ve daha fazlası
|
|
14
|
+
- **Dosya & Dizin Tarama** — Tek dosya veya tüm proje ağacı
|
|
15
|
+
- **Akıllı Atlama** — `node_modules`, `.git`, `dist`, `build`, `.next` gibi dizinler otomatik atlanır
|
|
16
|
+
- **Güvenli Redaksyon** — Eşleşmeler ilk 4 + yıldız + son 4 karakter olarak gösterilir
|
|
17
|
+
- **Allowlist Desteği** — Bilinen test/sahte değerleri beyaz listeye alın
|
|
18
|
+
- **16 Unit Test** — %100 geçen test paketi
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Hızlı Başlangıç
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
npm install -g @guardbee/mcp-secret-scanner
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
`claude_desktop_config.json` dosyasına ekleyin:
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"guardbee-secret-scanner": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "@guardbee/mcp-secret-scanner"]
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## MCP Tools
|
|
44
|
+
|
|
45
|
+
| Tool | Açıklama |
|
|
46
|
+
|------|----------|
|
|
47
|
+
| `scan_text` | Verilen metin içinde secret tarar |
|
|
48
|
+
| `scan_file` | Tek bir dosyayı tarar |
|
|
49
|
+
| `scan_directory` | Bir dizini ve alt dizinlerini yinelemeli olarak tarar |
|
|
50
|
+
| `list_patterns` | Tüm aktif secret desenlerini listeler |
|
|
51
|
+
|
|
52
|
+
### Örnek Kullanım
|
|
53
|
+
|
|
54
|
+
Claude'a şunu sorabilirsiniz:
|
|
55
|
+
|
|
56
|
+
> "Projemdeki gizli bilgileri tara: `/Users/me/my-app`"
|
|
57
|
+
|
|
58
|
+
> "Bu `.env` dosyasında secret var mı?"
|
|
59
|
+
|
|
60
|
+
> "Şu metin güvenli mi: `export API_KEY=sk-abc123...`"
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Tespit Edilen Secret Türleri
|
|
65
|
+
|
|
66
|
+
| Kategori | Örnekler |
|
|
67
|
+
|----------|---------|
|
|
68
|
+
| Cloud | AWS Access Key, AWS Secret, GCP API Key |
|
|
69
|
+
| Source Control | GitHub PAT, GitLab Token |
|
|
70
|
+
| Ödeme | Stripe Secret/Publishable Key |
|
|
71
|
+
| AI | OpenAI API Key, Anthropic API Key, HuggingFace Token |
|
|
72
|
+
| İletişim | Slack Bot Token, Twilio Auth Token, SendGrid Key |
|
|
73
|
+
| Veritabanı | PostgreSQL URL, MySQL URL, MongoDB URI, Redis URL |
|
|
74
|
+
| Kriptografi | RSA Private Key, EC Private Key, OpenSSH Key, PGP Key |
|
|
75
|
+
| Web | JWT Token, Bearer Token |
|
|
76
|
+
| Paket / Platform | npm Token, Docker Hub Token, Vercel Token |
|
|
77
|
+
| Genel | `SECRET=`, `PASSWORD=`, `API_KEY=` kalıpları |
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Güvenlik Notu
|
|
82
|
+
|
|
83
|
+
Bu araç tarama sonuçlarında eşleşen değerleri **kısmen redakte eder** (`sk_live_abc1...xyz9` gibi). Tam değerler asla log'a yazılmaz veya dışarı aktarılmaz.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Geliştirme
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
npm install
|
|
91
|
+
npm test # 16 unit test
|
|
92
|
+
npm run build # TypeScript derleme
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Lisans
|
|
98
|
+
|
|
99
|
+
MIT — [GuardBee](https://guardbee.ai)
|