English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt | हिन्दी


fingerprint-mcp

Uniwersalny cyfrowy fingerprinting dla agentow AI.

TCP, TLS/SSL, SSH, HTTP, DNS, WAF/CDN, IoT, SMTP, sondowanie uslug, JARM, JA4X, hashowanie favicon, topologia infrastruktury, wykrywanie C2, wzbogacanie OSINT — zunifikowane w jednym serwerze MCP.
Twoj agent AI otrzymuje fingerprinting pelnego spektrum na zadanie, a nie 11 odlaczonych narzedzi CLI i reczna korelacje.


Problem • Czym Sie Rozni • Szybki Start • Co Moze AI • Narzedzia (13) • Zrodla Danych • Architektura • Changelog • Wspoltworz

npm Licencja Bun MCP 13 Narzedzi 103 Techniki

Demo fingerprint-mcp

--- ## Problem Fingerprinting serwera dzisiaj oznacza zonglowanie tuzinem odlaczonych narzedzi. Uruchamiasz `nmap` do skanowania portow, `testssl.sh` do analizy certyfikatow, `curl -I` do naglowkow HTTP, `dig` do DNS, `wafw00f` do wykrywania WAF, `ssh-audit` do SSH, oddzielne narzedzie JARM, Wappalyzer do wykrywania technologii — a potem spedzasz 30 minut na recznym krizowym odniesieniu wszystkiego w arkuszu kalkulacyjnym, zeby dowiedziec sie, co naprawde dziala. ``` Tradycyjny przeplyw pracy fingerprintingu: analiza certyfikatow TLS -> testssl.sh / openssl s_client przechwytywanie naglowkow HTTP -> curl -I wykrywanie technologii web -> wappalyzer CLI rekonesans DNS -> dig / nslookup / dnsenum skanowanie portow -> nmap -sV wykrywanie WAF -> wafw00f audyt SSH -> ssh-audit fingerprinting uslug -> nmap scripts fingerprint JARM -> jarm (oddzielne narzedzie) sprawdzanie baz OSINT -> shodan CLI, censys CLI korelacja wszystkiego -> recznie w arkuszu kalkulacyjnym ────────────────────────────── Razem: 11 narzedzi, 30+ minut, reczna korelacja ``` **fingerprint-mcp** daje Twojemu agentowi AI 13 zlozonych narzedzi opakowujacych 103 techniki fingerprintingu w 21 dostawcach przez [Model Context Protocol](https://modelcontextprotocol.io). Agent uruchamia wielowarstwowy fingerprinting rownolegle, koreluje sygnaly miedzy warstwami TCP/TLS/HTTP/DNS/SSH, wykrywa honeypoty i infrastrukture C2 oraz przedstawia zunifikowany obraz wywiadowczy — w jednej rozmowie. ``` Z fingerprint-mcp: Ty: "Zrob glebokie rozpoznanie target.com" Agent: -> recon {url: "https://target.com", depth: "deep"} -> TLS: nginx/1.24.0 przez JARM (3fd21b20d00000...), certyfikat Let's Encrypt, 2 SAN, TLS 1.2+1.3 -> HTTP: Express.js za Cloudflare WAF, React SPA, Google Analytics, 14 naglowkow bezpieczenstwa przeanalizowanych -> DNS: rekordy A/AAAA/MX/TXT, SPF/DKIM/DMARC skonfigurowane, Slack + Google Workspace wykryte przez CNAME/MX -> Porty: 80, 443, 22 (OpenSSH 9.6), 8080 (serwer deweloperski) -> WAF: Cloudflare wykryty, IP zrodla odkryty przez bezposrednie polaczenie -> Enumeracja: 12 subdomen przez logi CT, wildcard DNS wykryty -> "target.com uruchamia nginx/1.24.0 z Express.js za Cloudflare WAF. IP zrodla 203.0.113.42 wystawiony na porcie 8080. TLS jest poprawnie skonfigurowany (rownowaznik A+), ale serwer deweloperski na 8080 nie ma ochrony WAF. 3 subdomeny wskazuja na wycofana infrastrukture — potencjalne ryzyko przejecia." ``` --- ## Czym Sie Rozni Istniejace narzedzia daja surowe dane po jednej warstwie na raz. fingerprint-mcp daje Twojemu agentowi AI mozliwosc **wnioskowania na wszystkich warstwach fingerprintingu jednoczesnie**.
Tradycyjne Podejscie fingerprint-mcp
Interfejs 11 roznych narzedzi CLI z roznymi formatami wyjscia MCP — agent AI wywoluje narzedzia konwersacyjnie
Techniki Jedno narzedzie, jedna warstwa na raz 103 techniki w 21 dostawcach, uruchamiane rownolegle
Analiza TLS Wyjscie testssl.sh, reczna analiza JARM oddzielnie Agent laczy certyfikat + JARM + JA4X + zestawy szyfrow + SNI + logi CT w jednym wywolaniu
Korelacja Kopiuj-wklej wyniki do arkusza kalkulacyjnego Agent koreluje krzyzowo: "JARM pasuje do znanego frameworka C2, timing HTTP potwierdza honeypot"
Obejscie WAF wafw00f wykrywa WAF, recznie szukasz zrodla Agent wykrywa WAF, odkrywa IP zrodla i weryfikuje, ze serwuje ta sama zawartosc
Klucze API Wymagane do Shodan, Censys itp. 80+ aktywnych technik dziala bez jakichkolwiek kluczy API; klucze odblokowuja wzbogacanie OSINT
Konfiguracja Zainstaluj nmap, testssl, wafw00f, ssh-audit, jarm, wappalyzer... npx fingerprint-mcp — jedno polecenie, zero konfiguracji
--- ## Szybki Start ### Opcja 1: npx (bez instalacji) ```bash npx fingerprint-mcp ``` Wszystkie 80+ aktywnych technik fingerprintingu dzialaja natychmiast. Klucze API nie sa wymagane do fingerprintingu TCP, TLS, SSH, HTTP, DNS, WAF, sciezek, uslug, timingu, IoT, SMTP i aplikacji. ### Opcja 2: Klonowanie ```bash git clone https://github.com/badchars/fingerprint-mcp.git cd fingerprint-mcp bun install ``` ### Zmienne srodowiskowe (opcjonalne) ```bash # Wzbogacanie OSINT (wszystkie opcjonalne — aktywny fingerprinting dziala bez jakichkolwiek kluczy) export SHODAN_API_KEY=your-key # Wlacza osint_shodan, ssh_hostkey_lookup export CENSYS_API_ID=your-id # Wlacza osint_censys (darmowy: 250 zapytan/miesiac) export CENSYS_API_SECRET=your-secret # Sekret API Censys export SECURITYTRAILS_API_KEY=your-key # Wlacza waf_origin, enum_passive_dns export VIRUSTOTAL_API_KEY=your-key # Wlacza osint_virustotal (darmowy: 500 zapytan/dzien) ``` Wszystkie klucze API sa opcjonalne. Bez nich nadal otrzymujesz pelny fingerprinting TCP/TLS/SSH/HTTP/DNS/WAF/sciezek/uslug/timingu/IoT/SMTP/infrastruktury/aplikacji, korelacje, analize pasywna, enumeracje i narzedzia meta — 80+ technik dzialajacych przez bezposrednie sondowanie celu. ### Polacz z agentem AI
Claude Code ```bash # Z npx claude mcp add fingerprint-mcp -- npx fingerprint-mcp # Z lokalnym klonem claude mcp add fingerprint-mcp -- bun run /path/to/fingerprint-mcp/src/index.ts ```
Claude Desktop Dodaj do `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "fingerprint": { "command": "npx", "args": ["-y", "fingerprint-mcp"], "env": { "SHODAN_API_KEY": "optional", "CENSYS_API_ID": "optional", "CENSYS_API_SECRET": "optional", "SECURITYTRAILS_API_KEY": "optional", "VIRUSTOTAL_API_KEY": "optional" } } } } ```
Cursor / Windsurf / inni klienci MCP Ten sam format konfiguracji JSON. Skieruj polecenie na `npx fingerprint-mcp` lub sciezke lokalnej instalacji.
### Zacznij pytac ``` Ty: "Zrob fingerprinting wszystkiego o target.com — TLS, stos HTTP, WAF, DNS, otwarte porty" ``` To wszystko. Agent automatycznie obsluguje wielowarstwowy fingerprinting, korelacje sygnalow i analize infrastruktury. --- ## Co Moze AI ### Szybki Rekonesans ``` Ty: "Szybki rekonesans target.com" Agent: -> recon {url: "https://target.com", depth: "quick"} -> TCP: porty 80, 443, 22 otwarte -> TLS: certyfikat RSA Let's Encrypt, TLS 1.2+1.3, sygnatura JARM nginx -> HTTP: nginx/1.24.0, Express.js, React, Cloudflare CDN -> DNS: A 203.0.113.42, MX Google Workspace, SPF/DKIM skonfigurowane -> WAF: Cloudflare wykryty (naglowek cf-ray) -> "target.com to React SPA na Express.js za nginx/1.24.0, serwowana przez Cloudflare CDN. TLS poprawnie skonfigurowany z Let's Encrypt. SSH na porcie 22 z OpenSSH 9.6. Poczta obslugiwana przez Google Workspace z pelnym SPF/DKIM/DMARC." ``` ### Doglebne Badanie TLS ``` Ty: "Przeanalizuj szczegolowo konfiguracje TLS suspicious-server.com" Agent: -> scan_tls {host: "suspicious-server.com"} -> Certyfikat: samopodpisany, CN=localhost, wygasl 47 dni temu -> JARM: 2ad2ad0002ad2ad00042d42d00000069d641f34fe76acdc05c40262f8815e5 (pasuje do domyslnego profilu Cobalt Strike) -> JA4X: fingerprint pasuje do znanego wzorca frameworka C2 -> Zestawy szyfrow: akceptuje slabe szyfry (RC4, 3DES) -> SNI: odpowiada identycznie na kazda wartosc SNI -> Logi CT: certyfikat nie jest zarejestrowany (nie jest publicznie zaufany) -> "WYSOKIE RYZYKO: Konfiguracja TLS silnie wskazuje na infrastrukture C2. Samopodpisany wygasly certyfikat, fingerprint JARM pasuje do Cobalt Strike, akceptuje slabe szyfry i odpowiada na dowolne wartosci SNI. Zalecane natychmiastowe zbadanie i zablokowanie." ``` ### Obejscie WAF i Odkrywanie Zrodla ``` Ty: "target.com jest za WAF. Czy mozesz znalezc serwer zrodlowy?" Agent: -> scan_waf {url: "https://target.com"} -> scan_dns {domain: "target.com"} -> enumerate {domain: "target.com"} -> WAF: Cloudflare (AS13335), strona wyzwania na podejrzane zadania -> DNS: rekord A wskazuje na IP Cloudflare 104.21.x.x -> Subdomeny: dev.target.com rozwiazuje do 203.0.113.42 (nie-Cloudflare) -> Bezposrednie polaczenie z 203.0.113.42:443 zwraca ten sam certyfikat TLS -> Historia SecurityTrails: zrodlo to 203.0.113.42 przed Cloudflare -> "Znaleziono IP zrodla: 203.0.113.42. Odkryty przez subdomene dev.target.com, ktora omija Cloudflare. Zrodlo serwuje ten sam certyfikat TLS i odpowiada na naglowek Host target.com. Zrodlo nie ma ochrony WAF — mozliwy bezposredni dostep." ``` ### Wykrywanie Uslug na Hoscie ``` Ty: "Jakie uslugi dzialaja na 10.0.1.50?" Agent: -> scan_ports {host: "10.0.1.50"} -> scan_services {host: "10.0.1.50", ports: [22, 80, 3306, 5432, 6379, 8080]} -> Port 22: OpenSSH 8.9p1 Ubuntu, klucz hosta ED25519 -> Port 80: Apache/2.4.57, PHP/8.2, WordPress 6.4 -> Port 3306: MySQL 8.0.36, wymagane uwierzytelnienie -> Port 5432: PostgreSQL 16.1, wymagany SSL -> Port 6379: Redis 7.2.4, BRAK uwierzytelnienia (otwarty) -> Port 8080: serwer deweloperski Node.js Express, CORS: * -> "KRYTYCZNE: Redis na porcie 6379 nie ma uwierzytelnienia — kazdy w sieci moze czytac/zapisywac dane. Serwer deweloperski Express na 8080 ma wildcard CORS. MySQL i PostgreSQL prawidlowo wymagaja uwierzytelnienia. WordPress jest o 2 mniejsze wersje w tyle. Wymagane natychmiastowe dzialanie w sprawie Redisa i ekspozycji serwera deweloperskiego." ``` --- ## Dokumentacja Narzedzi (13 narzedzi, 103 techniki)
recon — Pelny rekonesans z wyborem technik opartym na glebokosci | Parametr | Typ | Opis | |----------|-----|------| | `url` | string | Docelowy URL do fingerprintingu | | `depth` | `quick` \| `standard` \| `deep` | Glebokosc skanowania: quick=5 technik, standard=20, deep=50+ | Orkiestruje techniki ze wszystkich dostawcow na podstawie poziomu glebokosci. Tryb quick daje szybki przeglad; tryb deep uruchamia wyczerpujacy fingerprinting wlaczajac enumeracje, OSINT i korelacje.
scan_ports — Skanowanie portow TCP z wykrywaniem uslug (3 techniki) | Parametr | Typ | Opis | |----------|-----|------| | `host` | string | Host docelowy (IP lub domena) | | `ports` | number[] | Opcjonalny — konkretne porty do skanowania (domyslnie: popularne porty) | | Technika | Opis | |----------|------| | `tcp_probe` | Skanowanie TCP connect do wykrywania otwartych portow | | `tcp_banner` | Przechwytywanie bannerow na otwartych portach do identyfikacji uslug | | `tcp_analysis` | Analiza kombinacji portow i wnioskowanie uslug |
scan_tls — Kompletna analiza TLS/SSL (8 technik) | Parametr | Typ | Opis | |----------|-----|------| | `host` | string | Host docelowy (IP lub domena) | | `port` | number | Opcjonalny — port TLS (domyslnie: 443) | | Technika | Opis | |----------|------| | `tls_certificate` | Parsowanie certyfikatu X.509 — podmiot, wydawca, SAN, waznosc, lancuch | | `tls_jarm` | Aktywny fingerprinting JARM — 10 sond TLS Client Hello, 62-znakowy hash | | `tls_ja4x` | Pasywny fingerprinting TLS JA4X z wlasciwosci certyfikatu | | `tls_ciphers` | Enumeracja zestawow szyfrow i analiza sily | | `tls_protocols` | Wykrywanie obslugiwanych wersji protokolu TLS (SSLv3 do TLS 1.3) | | `tls_sni` | Testowanie zachowania SNI — domyslny certyfikat vs. zadana nazwa hosta | | `tls_ct_logs` | Wyszukiwanie w logach Certificate Transparency przez crt.sh | | `tls_ocsp` | Sprawdzanie staplingu OCSP i statusu uniewaznien |
scan_dns — Wywiad DNS (7 technik) | Parametr | Typ | Opis | |----------|-----|------| | `domain` | string | Domena docelowa | | Technika | Opis | |----------|------| | `dns_records` | Pelna enumeracja rekordow — A, AAAA, MX, NS, TXT, CNAME, SOA | | `dns_email_auth` | Analiza rekordow SPF, DKIM i DMARC | | `dns_saas` | Wykrywanie SaaS/uslug przez wzorce CNAME i MX (Slack, Zendesk itp.) | | `dns_server` | Fingerprinting serwera DNS (BIND, PowerDNS, Cloudflare itp.) | | `dns_takeover` | Wykrywanie przejecia subdomeny przez analize wiszacych CNAME | | `dns_zone` | Proba transferu strefy (AXFR) | | `dns_caa` | Analiza rekordow CAA dla ograniczen urzedow certyfikacji |
scan_http — Fingerprinting HTTP/web (29 technik) | Parametr | Typ | Opis | |----------|-----|------| | `url` | string | Docelowy URL | | Technika | Dostawca | Opis | |----------|---------|------| | `http_headers` | HTTP | Analiza naglowkow odpowiedzi i identyfikacja serwera | | `http_header_order` | HTTP | Fingerprint kolejnosci naglowkow (sygnatura oprogramowania serwera) | | `http_security_headers` | HTTP | Audyt naglowkow bezpieczenstwa (CSP, HSTS, X-Frame-Options itp.) | | `http_cookies` | HTTP | Analiza cookies — flagi, prefiksy, wykrywanie frameworka | | `http_methods` | HTTP | Enumeracja dozwolonych metod HTTP (OPTIONS) | | `http_cors` | HTTP | Analiza polityki CORS i wykrywanie blednej konfiguracji | | `http_compression` | HTTP | Obslugiwane algorytmy kompresji (gzip, br, zstd) | | `http_caching` | HTTP | Analiza naglowkow cache (wykrywanie CDN, reverse proxy) | | `http_etag` | HTTP | Analiza formatu ETag do identyfikacji backendu | | `http_error` | HTTP | Fingerprinting stron bledow (niestandardowe vs. domyslne strony bledow) | | `http_redirect` | HTTP | Analiza lancucha przekierowan | | `http_timing` | HTTP | Bazowy czas odpowiedzi do profilowania wydajnosci serwera | | `http_favicon` | HTTP | Hash favicon (MurmurHash3) do identyfikacji technologii | | `http_robots` | HTTP | Parsowanie robots.txt i ekstrakcja zabronionych sciezek | | `http_sitemap` | HTTP | Odkrywanie mapy witryny i ekstrakcja URL | | `http_wellknown` | HTTP | Odkrywanie endpointow .well-known (security.txt, openid itp.) | | `web_tech` | Web | Wykrywanie technologii przez wzorce HTML/JS/CSS | | `web_analytics` | Web | Wykrywanie uslug analityki i sledzenia | | `web_sourcemaps` | Web | Odkrywanie plikow source map | | `web_websocket` | Web | Wykrywanie endpointow WebSocket | | `web_graphql` | Web | Wykrywanie endpointow GraphQL i introspekcja | | `web_spa` | Web | Wykrywanie frameworkow aplikacji single-page | | `web_cdn` | Web | Wykrywanie CDN przez naglowki odpowiedzi i DNS | | `web_meta` | Web | Analiza metatagow HTML (generator, wskazowki frameworka) | | `web_feed` | Web | Odkrywanie kanalow RSS/Atom | | `h2_detect` | HTTP/2 | Wykrywanie obslugi protokolu HTTP/2 | | `h2_fingerprint` | HTTP/2 | Fingerprinting serwera HTTP/2 (SETTINGS, WINDOW_UPDATE) | | `h2_h3` | HTTP/2 | Wykrywanie obslugi HTTP/3 (QUIC) przez naglowek Alt-Svc | | `app_cms` | Application | Wykrywanie CMS (WordPress, Drupal, Joomla itp.) |
scan_paths — Wywiad sciezkowy (5 technik) | Parametr | Typ | Opis | |----------|-----|------| | `url` | string | Docelowy URL | | `categories` | string[] | Opcjonalny — kategorie do sprawdzenia (sensitive, git, debug, api, config) | | Technika | Opis | |----------|------| | `path_sensitive` | Odkrywanie wrazliwych plikow (pliki kopii zapasowych, pliki konfiguracyjne, zrzuty baz danych) | | `path_robots` | Analiza robots.txt i sitemap.xml dla ukrytych sciezek | | `path_git` | Wykrywanie wycieku repozytorium Git (.git/HEAD, .git/config) | | `path_debug` | Odkrywanie endpointow debug (phpinfo, server-status, konsole debug) | | `path_api` | Odkrywanie wersji API i endpointow dokumentacji |
scan_waf — Wykrywanie i fingerprinting WAF/CDN (4 techniki) | Parametr | Typ | Opis | |----------|-----|------| | `url` | string | Docelowy URL | | Technika | Opis | |----------|------| | `waf_detect` | Wykrywanie obecnosci WAF przez analize naglowkow odpowiedzi i zachowania | | `waf_cdn` | Identyfikacja dostawcy CDN (Cloudflare, Akamai, Fastly itp.) | | `waf_fingerprint` | Identyfikacja produktu WAF i wykrywanie wersji | | `waf_origin` | Odkrywanie IP zrodla za WAF/CDN (wymaga `SECURITYTRAILS_API_KEY`) |
scan_services — Sondowanie na poziomie uslug (12 technik) | Parametr | Typ | Opis | |----------|-----|------| | `host` | string | Host docelowy (IP lub domena) | | `ports` | number[] | Opcjonalny — konkretne porty do sondowania | | `service` | string | Opcjonalny — konkretna usluga do sondowania (mysql, postgres, redis, ftp, ssh, smtp, vnc, iot) | | Technika | Dostawca | Opis | |----------|---------|------| | `ssh_probe` | SSH | Wykrywanie wersji protokolu SSH i oprogramowania | | `ssh_algorithms` | SSH | Audyt algorytmow SSH (KEX, szyfry, MAC, typy kluczy hosta) | | `ssh_hostkey_lookup` | SSH | Wyszukiwanie klucza hosta SSH przez Shodan (wymaga `SHODAN_API_KEY`) | | `svc_mysql` | Service | Wykrywanie wersji MySQL i fingerprinting mozliwosci | | `svc_postgres` | Service | Wykrywanie wersji PostgreSQL i sprawdzanie obslugi SSL | | `svc_redis` | Service | Wykrywanie wersji Redis i status uwierzytelniania | | `svc_ftp` | Service | Analiza bannera FTP i sprawdzanie anonimowego logowania | | `svc_vnc_rdp` | Service | Wykrywanie uslug VNC/RDP i ocena bezpieczenstwa | | `smtp_banner` | SMTP | Analiza bannera SMTP i identyfikacja MTA | | `smtp_starttls` | SMTP | Obsluga SMTP STARTTLS i inspekcja certyfikatu | | `iot_detect` | IoT | Wykrywanie urzadzen IoT przez wzorce bannerow i domyslne strony | | `iot_upnp` | IoT | Odkrywanie urzadzen UPnP/SSDP w sieci lokalnej |
enumerate — Rozszerzanie zakresu (8 technik) | Parametr | Typ | Opis | |----------|-----|------| | `domain` | string | Domena docelowa | | Technika | Opis | |----------|------| | `enum_subdomains` | Enumeracja subdomen przez wiele metod | | `enum_wildcard` | Wykrywanie wildcard DNS | | `enum_tld` | Rozszerzenie TLD (target.com -> target.net, target.org itp.) | | `enum_related` | Odkrywanie powiazanych domen przez wspolna infrastrukture | | `enum_asn` | Odkrywanie sasiadow ASN — inne domeny w tej samej sieci | | `enum_ct` | Ekstrakcja subdomen z logow Certificate Transparency | | `enum_passive_dns` | Historia pasywnego DNS (wymaga `SECURITYTRAILS_API_KEY`) | | `enum_scope` | Podsumowanie zakresu i przeglad powierzchni ataku |
osint — Wzbogacanie OSINT (6 technik) | Parametr | Typ | Opis | |----------|-----|------| | `target` | string | Adres IP lub domena do wzbogacenia | | `type` | `ip` \| `domain` | Opcjonalny — typ celu (wykrywany automatycznie jesli pominieto) | | Technika | Auth | Opis | |----------|------|------| | `osint_shodan` | `SHODAN_API_KEY` | Wyszukiwanie hosta Shodan — otwarte porty, bannery, podatnosci, OS | | `osint_censys` | `CENSYS_API_ID` + `CENSYS_API_SECRET` | Dane hosta Censys — uslugi, TLS, system autonomiczny | | `osint_reverse_ip` | Brak | Odwrocone wyszukiwanie IP — inne domeny na tym samym IP | | `osint_whois` | Brak | Dane rejestracji WHOIS — rejestrator, daty, serwery nazw | | `osint_webarchive` | Brak | Historia Web Archive — pierwszy/ostatni snapshot, czestotliwosc zmian | | `osint_virustotal` | `VIRUSTOTAL_API_KEY` | Raport VirusTotal domena/IP — wykrycia, kategorie, DNS |
analyze — Pasywna analiza fingerprinta (3 tryby) | Parametr | Typ | Opis | |----------|-----|------| | `type` | `headers` \| `html` \| `banner` | Typ danych do analizy | | `data` | string | Surowe dane do analizy (wklej naglowki, HTML lub wyjscie bannera) | | Tryb | Opis | |------|------| | `fp_analyze_headers` | Pasywna analiza naglowkow HTTP — wykrywanie serwera, frameworka, proxy bez wysylania ruchu | | `fp_analyze_html` | Pasywna analiza HTML — wykrywanie technologii, identyfikacja frameworka ze zrodla | | `fp_analyze_banner` | Pasywna analiza bannera — identyfikacja uslug z surowego tekstu bannera |
correlate — Silnik korelacji wielu sygnalow (7 trybow) | Parametr | Typ | Opis | |----------|-----|------| | `type` | `consistency` \| `honeypot` \| `spoofing` \| `compare` \| `topology` \| `c2` \| `identify` | Tryb korelacji | | `signals` | object | Sygnaly fingerprinta do korelacji (roznia sie w zaleznosci od trybu) | | Tryb | Opis | |------|------| | `fp_consistency` | Sprawdzenie spojnosci sygnalow miedzywarstwowych — czy fingerprinty TCP, TLS, HTTP i DNS sa zgodne? | | `fp_honeypot` | Wykrywanie honeypotow — sprawdzanie niemozliwych kombinacji uslug i anomalii behawioralnych | | `fp_spoofing` | Wykrywanie spoofingu — identyfikacja niespojnosci naglowkow serwera vs. faktyczne zachowanie | | `fp_compare` | Porownanie obok siebie profili fingerprintow dwoch hostow | | `fp_topology` | Mapowanie topologii infrastruktury — lancuch CDN, load balancer, reverse proxy | | `fp_c2` | Wykrywanie frameworka C2 przez korelacje JARM, TLS, HTTP i timingu | | `fp_identify` | Identyfikacja oparta na hashach wobec bazy znanych sygnatur |
meta — Konfiguracja serwera i dane (3 tryby) | Parametr | Typ | Opis | |----------|-----|------| | `category` | string | Opcjonalny — filtruj wedlug kategorii | | Tryb | Opis | |------|------| | `fp_sources` | Lista wszystkich dostepnych zrodel danych z konfiguracja i statusem kluczy API | | `fp_config` | Konfiguracja serwera — wersja, zaladowani dostawcy, liczba technik | | `fp_signatures` | Lista bazy sygnatur — sygnatury JARM, bannerow, WAF, aplikacji |
--- ### Uzycie CLI ```bash # Wyswietl wszystkie dostepne narzedzia i techniki npx fingerprint-mcp --list # Uruchom dowolne narzedzie bezposrednio npx fingerprint-mcp --tool recon '{"url":"https://example.com","depth":"quick"}' npx fingerprint-mcp --tool scan_tls '{"host":"example.com"}' npx fingerprint-mcp --tool scan_ports '{"host":"10.0.1.50","ports":[22,80,443,3306,8080]}' npx fingerprint-mcp --tool scan_dns '{"domain":"example.com"}' npx fingerprint-mcp --tool scan_http '{"url":"https://example.com"}' npx fingerprint-mcp --tool scan_waf '{"url":"https://example.com"}' npx fingerprint-mcp --tool scan_services '{"host":"10.0.1.50","service":"redis"}' npx fingerprint-mcp --tool enumerate '{"domain":"example.com"}' npx fingerprint-mcp --tool analyze '{"type":"headers","data":"Server: nginx/1.24.0\nX-Powered-By: Express"}' npx fingerprint-mcp --tool correlate '{"type":"honeypot","signals":{"jarm":"...","banner":"..."}}' npx fingerprint-mcp --tool meta '{}' # Narzedzia OSINT (wymagaja kluczy API) SHODAN_API_KEY=your-key npx fingerprint-mcp --tool osint '{"target":"203.0.113.42","type":"ip"}' ``` --- ## Zrodla Danych (21) | Zrodlo | Auth | Co zapewnia | |--------|------|-------------| | Sondowanie TCP | Brak | Skanowanie portow, przechwytywanie bannerow, wykrywanie uslug | | Analiza TLS/SSL | Brak | Parsowanie certyfikatow, fingerprinting JARM, JA4X, enumeracja szyfrow, testowanie SNI | | Sondowanie SSH | Brak | Wersja protokolu, audyt algorytmow, wykrywanie oprogramowania | | Analiza HTTP | Brak | Fingerprinting naglowkow, hashowanie favicon, analiza cookies, enumeracja metod, CORS | | Wykrywanie web | Brak | Wykrywanie technologii, analityka, source mapy, WebSocket, GraphQL, frameworki SPA | | Odkrywanie sciezek | Brak | Wrazliwe pliki, wycieki git, endpointy debug, wersje API, robots.txt | | Rozwiazywanie DNS | Brak | Enumeracja rekordow, analiza uwierzytelniania email, wykrywanie SaaS, fingerprinting serwera | | Wykrywanie WAF/CDN | Brak | Identyfikacja WAF, wykrywanie CDN, fingerprinting WAF | | Analiza timingu | Brak | Bazowy czas odpowiedzi, wykrywanie przesuniecia zegara | | HTTP/2 i HTTP/3 | Brak | Wykrywanie i fingerprinting HTTP/2, odkrywanie HTTP/3 Alt-Svc | | Sondowanie SMTP | Brak | Analiza bannera SMTP, inspekcja STARTTLS | | IoT/Embedded | Brak | Wykrywanie urzadzen IoT, odkrywanie UPnP/SSDP | | Wykrywanie aplikacji | Brak | Identyfikacja CMS, frameworkow i platform e-commerce | | Sondowanie uslug | Brak | Fingerprinting MySQL, PostgreSQL, Redis, FTP, VNC/RDP | | Wykrywanie infrastruktury | Brak | Identyfikacja dostawcy chmury, hostingu, CDN | | Silnik korelacji | Brak | Spojnosc sygnalow, wykrywanie honeypotow, wykrywanie spoofingu, mapowanie topologii | | Silnik identyfikacji | Brak | Identyfikacja oparta na hashach, wykrywanie C2, dopasowywanie sygnatur | | [Shodan](https://www.shodan.io) | `SHODAN_API_KEY` | Wywiad o hoscie — otwarte porty, bannery, podatnosci, wykrywanie OS | | [Censys](https://censys.io) | `CENSYS_API_ID` | Dane hosta — uslugi, certyfikaty TLS, informacje o systemie autonomicznym | | [SecurityTrails](https://securitytrails.com) | `SECURITYTRAILS_API_KEY` | Odkrywanie zrodla WAF, historia pasywnego DNS, rekordy historyczne | | [VirusTotal](https://www.virustotal.com) | `VIRUSTOTAL_API_KEY` | Reputacja domeny/IP, wyniki wykrywania, historia DNS, kategorie | --- ## Architektura ``` src/ index.ts # Punkt wejscia CLI (--help, --list, --tool, serwer stdio) protocol/ mcp-server.ts # Konfiguracja serwera MCP (transport stdio) tools.ts # Rejestr narzedzi — wszystkie 13 zlozonych narzedzi zarejestrowanych tutaj types/ index.ts # Wspoldzielone typy (ToolDef, ToolContext, ToolResult) utils/ rate-limiter.ts # Rate limiter per dostawca cache.ts # Cache TTL dla odpowiedzi API require-key.ts # Helper walidacji kluczy API murmurhash3.ts # MurmurHash3 do hashowania favicon composite/ # 13 orkiestratorow zlozonych narzedzi recon.ts # Orkiestrator pelnego rekonesansu (quick/standard/deep) scan-ports.ts # Zlozony skan portow scan-tls.ts # Zlozona analiza TLS scan-dns.ts # Zlozony wywiad DNS scan-http.ts # Zlozony fingerprinting HTTP scan-paths.ts # Zlozone odkrywanie sciezek scan-waf.ts # Zlozone wykrywanie WAF/CDN scan-services.ts # Zlozone sondowanie uslug analyze.ts # Zlozona analiza pasywna correlate.ts # Zlozony silnik korelacji enumerate.ts # Zlozone rozszerzanie zakresu osint.ts # Zlozone wzbogacanie OSINT meta.ts # Zlozony meta serwera helpers.ts # Wspoldzielone helpery zlozonych tcp/ # Techniki sondowania TCP (3) tls/ # Techniki analizy TLS/SSL (8) ssh/ # Techniki sondowania SSH (3) http/ # Techniki fingerprintingu HTTP (16) web/ # Techniki wykrywania technologii web (9) path/ # Techniki odkrywania sciezek (5) dns/ # Techniki wywiadu DNS (7) waf/ # Techniki wykrywania WAF/CDN (4) timing/ # Techniki analizy timingu (2) h2/ # Techniki HTTP/2 i HTTP/3 (3) smtp/ # Techniki sondowania SMTP (2) iot/ # Techniki wykrywania IoT/embedded (2) app/ # Techniki wykrywania aplikacji (3) service/ # Techniki sondowania uslug (5) infra/ # Techniki wykrywania infrastruktury (3) correlation/ # Silnik korelacji (5) identify/ # Silnik identyfikacji (3) passive/ # Analiza pasywna (3) osint/ # Techniki wzbogacania OSINT (6) enum/ # Techniki enumeracji (8) meta/ # Narzedzia meta (3) data/ # Bazy sygnatur i biblioteki wzorcow jarm-signatures.ts # Znane fingerprinty JARM (C2, serwery, CDN) waf-signatures.ts # Sygnatury wykrywania WAF service-banners.ts # Wzorce bannerow uslug tech-patterns.ts # Wzorce wykrywania technologii favicon-hashes.ts # Znane wartosci MurmurHash3 favicon c2-signatures.ts # Sygnatury frameworkow C2 ... # 15+ baz sygnatur/wzorcow ``` **Decyzje projektowe:** - **13 zlozonych narzedzi, 103 techniki** — Agent wywoluje narzedzia wysokiego poziomu (`recon`, `scan_tls`, `scan_http`). Kazde zlozone narzedzie orkiestruje wiele technik niskiego poziomu i zwraca skorelowane wyniki. To redukuje narzut wywolan narzedzi zachowujac granularnosc. - **21 dostawcow, 1 serwer** — Kazda warstwa fingerprintingu jest niezaleznym modulem. Zlozony orkiestrator wybiera techniki na podstawie kontekstu i glebokosci. - **Najpierw aktywne, OSINT opcjonalnie** — 80+ technik dziala przez bezposrednie sondowanie celu bez jakichkolwiek kluczy API. Dostawcy OSINT (Shodan, Censys, VirusTotal, SecurityTrails) dodaja wzbogacenie, ale nigdy nie sa wymagani. - **Rate limitery per dostawca** — Kazdy dostawca ma wlasna instancje `RateLimiter`. Aktywne sondowanie jest ograniczone szybkoscia, aby uniknac wykrycia; API OSINT sa skalibrowane do swoich limitow. - **Cache TTL** — Rekordy DNS (10min), wyniki OSINT (15min), logi CT (30min) sa cachowane, aby uniknac nadmiarowych wyszukiwan podczas wielonarzedziowych przeplywow pracy. - **Lagodna degradacja** — Brakujace klucze API nie powoduja awarii serwera. Narzedzia OSINT zwracaja opisowe komunikaty: "Ustaw SHODAN_API_KEY, aby wlaczyc wyszukiwanie hostow Shodan." - **3 zaleznosci** — `@modelcontextprotocol/sdk`, `zod` i `cheerio`. Cale sieciowe I/O przez natywne `fetch()` i moduly Node.js `net`/`tls`/`dns`. Bez nmap, bez zewnetrznych plikow binarnych. --- ## Ograniczenia - Narzedzia OSINT (Shodan, Censys, VirusTotal, SecurityTrails) wymagaja kluczy API dla swoich odpowiednich technik - Darmowy plan Censys ograniczony do 250 zapytan/miesiac - Darmowy plan VirusTotal ograniczony do 500 zapytan/dzien - Skanowanie portow uzywa TCP connect (nie skanowania SYN) — mniej ukradkowe niz nmap, ale nie wymaga uprawnien root - Fingerprinting JARM wymaga bezposredniego dostepu TCP do celu (moze byc blokowany przez zapory sieciowe) - Odkrywanie UPnP/SSDP dziala tylko w sieciach lokalnych - Sondowanie uslug (MySQL, PostgreSQL, Redis) laczy sie, ale nie uwierzytelnia - Enumeracja subdomen opiera sie na logach CT i zrodlach pasywnych (bez brute-force) - Testowane na macOS / Linux (Windows nie testowany) --- ## Czesc Pakietu Bezpieczenstwa MCP | Projekt | Domena | Narzedzia | |---------|--------|-----------| | [hackbrowser-mcp](https://github.com/badchars/hackbrowser-mcp) | Testy bezpieczenstwa oparte na przegladarce | 39 narzedzi, Firefox, testy iniekcji | | [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) | Bezpieczenstwo chmury (AWS/Azure/GCP) | 38 narzedzi, 60+ kontroli | | [github-security-mcp](https://github.com/badchars/github-security-mcp) | Postawa bezpieczenstwa GitHub | 39 narzedzi, 45 kontroli | | [cve-mcp](https://github.com/badchars/cve-mcp) | Wywiad o podatnosciach | 23 narzedzia, 5 zrodel | | [osint-mcp-server](https://github.com/badchars/osint-mcp-server) | OSINT i rekonesans | 37 narzedzi, 12 zrodel | | [darknet-mcp-server](https://github.com/badchars/darknet-mcp-server) | Dark web i wywiad o zagrozeniach | 66 narzedzi, 16 zrodel | | **fingerprint-mcp** | **Uniwersalny cyfrowy fingerprinting** | **13 narzedzi, 103 techniki, 21 dostawcow** | ---

Wylacznie do autoryzowanych testow bezpieczenstwa i ocen.
Zawsze upewnij sie, ze masz odpowiednia autoryzacje przed wykonaniem fingerprintingu na jakimkolwiek celu.

Licencja AGPL-3.0 • Zbudowane z Bun + TypeScript