English |
简体中文 |
繁體中文 |
한국어 |
Deutsch |
Español |
Français |
Italiano |
Dansk |
日本語 |
Polski |
Русский |
Bosanski |
العربية |
Norsk |
Português (Brasil) |
ไทย |
Türkçe |
Українська |
বাংলা |
Ελληνικά |
Tiếng Việt |
हिन्दी
AIエージェントのためのユニバーサルデジタルフィンガープリンティング。
TCP、TLS/SSL、SSH、HTTP、DNS、WAF/CDN、IoT、SMTP、サービスプローブ、JARM、JA4X、faviconハッシュ、インフラトポロジー、C2検出、OSINT エンリッチメント — すべてを単一のMCPサーバーに統合。
AIエージェントはフルスペクトルのフィンガープリンティングをオンデマンドで実行できます。11個のバラバラなCLIツールと手動の相関作業は不要です。
問題点 •
何が違うのか •
クイックスタート •
AIにできること •
ツール（13） •
データソース •
アーキテクチャ •
変更履歴 •
コントリビュート
---
## 問題点
今日、サーバーのフィンガープリンティングを行うには、十数個のバラバラなツールを使い分ける必要があります。ポートスキャンには`nmap`、証明書分析には`testssl.sh`、HTTPヘッダーには`curl -I`、DNSには`dig`、WAF検出には`wafw00f`、SSHには`ssh-audit`、別途JARMツール、技術検出にはWappalyzer — そして、実際に何が動いているかを把握するために、すべてをスプレッドシートで手動で相互参照するのに30分を費やします。
```
従来のフィンガープリンティングワークフロー：
TLS証明書の分析 -> testssl.sh / openssl s_client
HTTPヘッダーの取得 -> curl -I
Web技術の検出 -> wappalyzer CLI
DNSリコネサンス -> dig / nslookup / dnsenum
ポートスキャン -> nmap -sV
WAF検出 -> wafw00f
SSH監査 -> ssh-audit
サービスフィンガープリント -> nmap scripts
JARMフィンガープリント -> jarm（別ツール）
OSINTデータベースの確認 -> shodan CLI, censys CLI
すべてを相関 -> スプレッドシートで手動
──────────────────────────────
合計：11ツール、30分以上、手動相関
```
**fingerprint-mcp**は、AIエージェントに[Model Context Protocol](https://modelcontextprotocol.io)を介して21プロバイダーにわたる103のフィンガープリンティングテクニックを包含する13のコンポジットツールを提供します。エージェントはマルチレイヤーフィンガープリンティングを並列実行し、TCP/TLS/HTTP/DNS/SSHレイヤー間のシグナルを相関させ、ハニーポットやC2インフラを検出し、統合されたインテリジェンス画像を提示します — 単一の会話の中で。
```
fingerprint-mcpを使用：
あなた："target.comの詳細なリコンを実行して"
エージェント: -> recon {url: "https://target.com", depth: "deep"}
-> TLS: JARM経由でnginx/1.24.0 (3fd21b20d00000...)、
Let's Encrypt証明書、SAN 2件、TLS 1.2+1.3
-> HTTP: Cloudflare WAFの背後にExpress.js、
React SPA、Google Analytics、14のセキュリティヘッダーを分析
-> DNS: A/AAAA/MX/TXTレコード、SPF/DKIM/DMARC設定済み、
CNAME/MX経由でSlack + Google Workspaceを検出
-> ポート: 80、443、22（OpenSSH 9.6）、8080（開発サーバー）
-> WAF: Cloudflare検出、直接接続によりオリジンIPを発見
-> 列挙: CTログ経由で12サブドメイン、ワイルドカードDNS検出
-> "target.comはCloudflare WAFの背後でnginx/1.24.0上の
Express.jsを実行しています。オリジンIP 203.0.113.42がポート
8080で公開されています。TLSは正しく設定されていますが（A+相当）、
8080の開発サーバーにはWAF保護がありません。3つのサブドメインが
廃止されたインフラを指しています — テイクオーバーのリスクがあります。"
```
---
## 何が違うのか
既存のツールは一度に一つのレイヤーの生データしか提供しません。fingerprint-mcpはAIエージェントに**すべてのフィンガープリンティングレイヤーを同時に推論する能力**を与えます。
|
従来のアプローチ |
fingerprint-mcp |
| インターフェース |
異なる出力形式の11個のCLIツール |
MCP — AIエージェントが会話形式でツールを呼び出す |
| テクニック |
1ツール、1レイヤーずつ |
21プロバイダーにわたる103テクニック、並列実行 |
| TLS分析 |
testssl.shの出力、JARMを別途手動解析 |
エージェントが証明書 + JARM + JA4X + 暗号スイート + SNI + CTログを一回の呼び出しで統合 |
| 相関 |
結果をスプレッドシートにコピペ |
エージェントが相互相関：「JARMが既知のC2フレームワークに一致、HTTPタイミングがハニーポットを確認」 |
| WAFバイパス |
wafw00fがWAFを検出、手動でオリジンを探索 |
エージェントがWAFを検出し、オリジンIPを発見し、同じコンテンツを配信していることを検証 |
| APIキー |
Shodan、Censysなどに必須 |
80以上のアクティブテクニックがAPIキーなしで動作、キーはOSINTエンリッチメントを有効化 |
| セットアップ |
nmap、testssl、wafw00f、ssh-audit、jarm、wappalyzerをインストール... |
npx fingerprint-mcp — 一つのコマンド、設定不要 |
---
## クイックスタート
### オプション1：npx（インストール不要）
```bash
npx fingerprint-mcp
```
80以上のアクティブフィンガープリンティングテクニックがすぐに動作します。TCP、TLS、SSH、HTTP、DNS、WAF、パス、サービス、タイミング、IoT、SMTP、アプリケーションのフィンガープリンティングにAPIキーは不要です。
### オプション2：クローン
```bash
git clone https://github.com/badchars/fingerprint-mcp.git
cd fingerprint-mcp
bun install
```
### 環境変数（オプション）
```bash
# OSINTエンリッチメント（すべてオプション — アクティブフィンガープリンティングはキーなしで動作）
export SHODAN_API_KEY=your-key # osint_shodan、ssh_hostkey_lookupを有効化
export CENSYS_API_ID=your-id # osint_censysを有効化（無料：250クエリ/月）
export CENSYS_API_SECRET=your-secret # Censys APIシークレット
export SECURITYTRAILS_API_KEY=your-key # waf_origin、enum_passive_dnsを有効化
export VIRUSTOTAL_API_KEY=your-key # osint_virustotalを有効化（無料：500クエリ/日）
```
すべてのAPIキーはオプションです。キーがなくても、完全なTCP/TLS/SSH/HTTP/DNS/WAF/パス/サービス/タイミング/IoT/SMTP/インフラ/アプリケーションのフィンガープリンティング、相関、パッシブ分析、列挙、メタツール — ターゲットを直接プローブする80以上のテクニックが利用できます。
### AIエージェントへの接続
Claude Code
```bash
# npxを使用
claude mcp add fingerprint-mcp -- npx fingerprint-mcp
# ローカルクローンを使用
claude mcp add fingerprint-mcp -- bun run /path/to/fingerprint-mcp/src/index.ts
```
Claude Desktop
`~/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 / その他のMCPクライアント
同じJSON設定形式です。コマンドを`npx fingerprint-mcp`またはローカルインストールパスに向けてください。
### クエリの開始
```
あなた："target.comのすべてをフィンガープリントして — TLS、HTTPスタック、WAF、DNS、開いているポート"
```
以上です。エージェントがマルチレイヤーフィンガープリンティング、シグナル相関、インフラ分析を自動的に処理します。
---
## AIにできること
### クイックリコン
```
あなた："target.comのクイックリコン"
エージェント: -> recon {url: "https://target.com", depth: "quick"}
-> TCP: ポート80、443、22がオープン
-> TLS: Let's Encrypt RSA証明書、TLS 1.2+1.3、nginx JARMシグネチャ
-> HTTP: nginx/1.24.0、Express.js、React、Cloudflare CDN
-> DNS: A 203.0.113.42、MX Google Workspace、SPF/DKIM設定済み
-> WAF: Cloudflare検出（cf-rayヘッダー）
-> "target.comはnginx/1.24.0の背後でExpress.js上のReact SPAで、
Cloudflare CDN経由で配信されています。TLSはLet's Encryptで
適切に設定されています。ポート22でOpenSSH 9.6が動作。メールは
完全なSPF/DKIM/DMARCでGoogle Workspaceが処理。"
```
### 詳細なTLS調査
```
あなた："suspicious-server.comのTLS設定を詳しく分析して"
エージェント: -> scan_tls {host: "suspicious-server.com"}
-> 証明書: 自己署名、CN=localhost、47日前に期限切れ
-> JARM: 2ad2ad0002ad2ad00042d42d00000069d641f34fe76acdc05c40262f8815e5
（Cobalt Strikeのデフォルトプロファイルに一致）
-> JA4X: フィンガープリントが既知のC2フレームワークパターンに一致
-> 暗号スイート: 弱い暗号を受け入れる（RC4、3DES）
-> SNI: 任意のSNI値に対して同一の応答
-> CTログ: 証明書が記録されていない（公的に信頼されていない）
-> "高リスク: TLS設定はC2インフラを強く示唆しています。
自己署名の期限切れ証明書、JARMフィンガープリントがCobalt Strikeに一致、
弱い暗号を受け入れ、任意のSNI値に応答します。
即座の調査とブロックを推奨します。"
```
### WAFバイパスとオリジン発見
```
あなた："target.comはWAFの背後にあります。オリジンサーバーを見つけられますか？"
エージェント: -> scan_waf {url: "https://target.com"}
-> scan_dns {domain: "target.com"}
-> enumerate {domain: "target.com"}
-> WAF: Cloudflare（AS13335）、不審なリクエストにチャレンジページ
-> DNS: AレコードがCloudflare IP 104.21.x.xを指す
-> サブドメイン: dev.target.comが203.0.113.42に解決（非Cloudflare）
-> 203.0.113.42:443への直接接続で同じTLS証明書を返す
-> SecurityTrails履歴: Cloudflare以前のオリジンは203.0.113.42
-> "オリジンIP発見: 203.0.113.42。Cloudflareをバイパスする
dev.target.comサブドメイン経由で発見。オリジンは同じTLS証明書を
配信し、target.comのHostヘッダーに応答します。
オリジンにはWAF保護がありません — 直接アクセスが可能です。"
```
### ホスト上のサービス検出
```
あなた："10.0.1.50で何のサービスが動いていますか？"
エージェント: -> scan_ports {host: "10.0.1.50"}
-> scan_services {host: "10.0.1.50", ports: [22, 80, 3306, 5432, 6379, 8080]}
-> ポート22: OpenSSH 8.9p1 Ubuntu、ED25519ホストキー
-> ポート80: Apache/2.4.57、PHP/8.2、WordPress 6.4
-> ポート3306: MySQL 8.0.36、認証必須
-> ポート5432: PostgreSQL 16.1、SSL必須
-> ポート6379: Redis 7.2.4、認証なし（オープン）
-> ポート8080: Node.js Express開発サーバー、CORS: *
-> "重大: ポート6379のRedisに認証がありません — ネットワーク上の
誰でもデータの読み書きが可能です。8080のExpress開発サーバーは
ワイルドカードCORSです。MySQLとPostgreSQLは適切に認証を要求して
います。WordPressは2マイナーバージョン遅れています。Redisと
開発サーバーの露出に対する即座の対応が必要です。"
```
---
## ツールリファレンス（13ツール、103テクニック）
recon — 深度ベースのテクニック選択による完全なリコネサンス
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `url` | string | フィンガープリントするターゲットURL |
| `depth` | `quick` \| `standard` \| `deep` | スキャン深度: quick=5テクニック、standard=20、deep=50+ |
深度レベルに基づいてすべてのプロバイダーからテクニックをオーケストレーションします。クイックモードは素早い概要を提供し、ディープモードは列挙、OSINT、相関を含む徹底的なフィンガープリンティングを実行します。
scan_ports — サービス検出付きTCPポートスキャン（3テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `host` | string | ターゲットホスト（IPまたはドメイン） |
| `ports` | number[] | オプション — スキャンする特定のポート（デフォルト: 一般的なポート） |
| テクニック | 説明 |
|-----------|-------------|
| `tcp_probe` | オープンポートを検出するTCPコネクトスキャン |
| `tcp_banner` | サービス識別のためのオープンポートでのバナー取得 |
| `tcp_analysis` | ポート組み合わせ分析とサービス推論 |
scan_tls — 完全なTLS/SSL分析（8テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `host` | string | ターゲットホスト（IPまたはドメイン） |
| `port` | number | オプション — TLSポート（デフォルト: 443） |
| テクニック | 説明 |
|-----------|-------------|
| `tls_certificate` | X.509証明書の解析 — サブジェクト、発行者、SAN、有効期限、チェーン |
| `tls_jarm` | JARMアクティブフィンガープリンティング — 10のTLS Client Helloプローブ、62文字ハッシュ |
| `tls_ja4x` | 証明書プロパティからのJA4Xパッシブ TLSフィンガープリンティング |
| `tls_ciphers` | 暗号スイートの列挙と強度分析 |
| `tls_protocols` | サポートされるTLSプロトコルバージョンの検出（SSLv3からTLS 1.3） |
| `tls_sni` | SNI動作テスト — デフォルト証明書 vs. 要求されたホスト名 |
| `tls_ct_logs` | crt.sh経由のCertificate Transparencyログ検索 |
| `tls_ocsp` | OCSPステープリングと失効ステータスの確認 |
scan_dns — DNSインテリジェンス（7テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `domain` | string | ターゲットドメイン |
| テクニック | 説明 |
|-----------|-------------|
| `dns_records` | 完全なレコード列挙 — A、AAAA、MX、NS、TXT、CNAME、SOA |
| `dns_email_auth` | SPF、DKIM、DMARCレコード分析 |
| `dns_saas` | CNAMEとMXパターンによるSaaS/サービス検出（Slack、Zendeskなど） |
| `dns_server` | DNSサーバーフィンガープリンティング（BIND、PowerDNS、Cloudflareなど） |
| `dns_takeover` | ダングリングCNAME分析によるサブドメインテイクオーバー検出 |
| `dns_zone` | ゾーン転送試行（AXFR） |
| `dns_caa` | 認証局制限のためのCAAレコード分析 |
scan_http — HTTP/Webフィンガープリンティング（29テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `url` | string | ターゲットURL |
| テクニック | プロバイダー | 説明 |
|-----------|----------|-------------|
| `http_headers` | HTTP | レスポンスヘッダー分析とサーバー識別 |
| `http_header_order` | HTTP | ヘッダー順序フィンガープリント（サーバーソフトウェアシグネチャ） |
| `http_security_headers` | HTTP | セキュリティヘッダー監査（CSP、HSTS、X-Frame-Optionsなど） |
| `http_cookies` | HTTP | Cookie分析 — フラグ、プレフィックス、フレームワーク検出 |
| `http_methods` | HTTP | 許可されたHTTPメソッドの列挙（OPTIONS） |
| `http_cors` | HTTP | CORSポリシー分析と誤設定検出 |
| `http_compression` | HTTP | サポートされる圧縮アルゴリズム（gzip、br、zstd） |
| `http_caching` | HTTP | キャッシュヘッダー分析（CDN、リバースプロキシ検出） |
| `http_etag` | HTTP | バックエンド識別のためのETagフォーマット分析 |
| `http_error` | HTTP | エラーページフィンガープリンティング（カスタム vs. デフォルトエラーページ） |
| `http_redirect` | HTTP | リダイレクトチェーン分析 |
| `http_timing` | HTTP | サーバーパフォーマンスプロファイリングのためのレスポンスタイミングベースライン |
| `http_favicon` | HTTP | 技術識別のためのfaviconハッシュ（MurmurHash3） |
| `http_robots` | HTTP | robots.txtの解析と禁止パスの抽出 |
| `http_sitemap` | HTTP | サイトマップの発見とURL抽出 |
| `http_wellknown` | HTTP | .well-knownエンドポイントの発見（security.txt、openidなど） |
| `web_tech` | Web | HTML/JS/CSSパターンによる技術検出 |
| `web_analytics` | Web | アナリティクスおよびトラッキングサービスの検出 |
| `web_sourcemaps` | Web | ソースマップファイルの発見 |
| `web_websocket` | Web | WebSocketエンドポイントの検出 |
| `web_graphql` | Web | GraphQLエンドポイントの検出とイントロスペクション |
| `web_spa` | Web | シングルページアプリケーションフレームワークの検出 |
| `web_cdn` | Web | レスポンスヘッダーとDNS経由のCDN検出 |
| `web_meta` | Web | HTMLメタタグ分析（ジェネレーター、フレームワークのヒント） |
| `web_feed` | Web | RSS/Atomフィードの発見 |
| `h2_detect` | HTTP/2 | HTTP/2プロトコルサポートの検出 |
| `h2_fingerprint` | HTTP/2 | HTTP/2サーバーフィンガープリンティング（SETTINGS、WINDOW_UPDATE） |
| `h2_h3` | HTTP/2 | Alt-Svcヘッダー経由のHTTP/3（QUIC）サポート検出 |
| `app_cms` | Application | CMS検出（WordPress、Drupal、Joomlaなど） |
scan_paths — パスインテリジェンス（5テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `url` | string | ターゲットURL |
| `categories` | string[] | オプション — 確認するカテゴリ（sensitive、git、debug、api、config） |
| テクニック | 説明 |
|-----------|-------------|
| `path_sensitive` | 機密ファイルの発見（バックアップファイル、設定ファイル、データベースダンプ） |
| `path_robots` | 隠しパスのためのrobots.txtとsitemap.xmlの分析 |
| `path_git` | Gitリポジトリ漏洩検出（.git/HEAD、.git/config） |
| `path_debug` | デバッグエンドポイントの発見（phpinfo、server-status、デバッグコンソール） |
| `path_api` | APIバージョンとドキュメントエンドポイントの発見 |
scan_waf — WAF/CDN検出とフィンガープリンティング（4テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `url` | string | ターゲットURL |
| テクニック | 説明 |
|-----------|-------------|
| `waf_detect` | レスポンスヘッダーと動作分析によるWAF存在検出 |
| `waf_cdn` | CDNプロバイダー識別（Cloudflare、Akamai、Fastlyなど） |
| `waf_fingerprint` | WAF製品識別とバージョン検出 |
| `waf_origin` | WAF/CDN背後のオリジンIP発見（`SECURITYTRAILS_API_KEY`が必要） |
scan_services — サービスレベルプローブ（12テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `host` | string | ターゲットホスト（IPまたはドメイン） |
| `ports` | number[] | オプション — プローブする特定のポート |
| `service` | string | オプション — プローブする特定のサービス（mysql、postgres、redis、ftp、ssh、smtp、vnc、iot） |
| テクニック | プロバイダー | 説明 |
|-----------|----------|-------------|
| `ssh_probe` | SSH | SSHプロトコルバージョンとソフトウェア検出 |
| `ssh_algorithms` | SSH | SSHアルゴリズム監査（KEX、暗号、MAC、ホストキータイプ） |
| `ssh_hostkey_lookup` | SSH | Shodan経由のSSHホストキー検索（`SHODAN_API_KEY`が必要） |
| `svc_mysql` | Service | MySQLバージョン検出と機能フィンガープリンティング |
| `svc_postgres` | Service | PostgreSQLバージョン検出とSSLサポート確認 |
| `svc_redis` | Service | Redisバージョン検出と認証ステータス |
| `svc_ftp` | Service | FTPバナー分析と匿名ログイン確認 |
| `svc_vnc_rdp` | Service | VNC/RDPサービス検出とセキュリティ評価 |
| `smtp_banner` | SMTP | SMTPバナー分析とMTA識別 |
| `smtp_starttls` | SMTP | SMTP STARTTLSサポートと証明書検査 |
| `iot_detect` | IoT | バナーパターンとデフォルトページによるIoTデバイス検出 |
| `iot_upnp` | IoT | ローカルネットワーク上のUPnP/SSDPデバイス検出 |
enumerate — スコープ拡張（8テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `domain` | string | ターゲットドメイン |
| テクニック | 説明 |
|-----------|-------------|
| `enum_subdomains` | 複数の方法によるサブドメイン列挙 |
| `enum_wildcard` | ワイルドカードDNS検出 |
| `enum_tld` | TLD拡張（target.com -> target.net、target.orgなど） |
| `enum_related` | 共有インフラ経由の関連ドメイン発見 |
| `enum_asn` | ASN近隣発見 — 同じネットワーク上の他のドメイン |
| `enum_ct` | Certificate Transparencyログからのサブドメイン抽出 |
| `enum_passive_dns` | パッシブDNS履歴（`SECURITYTRAILS_API_KEY`が必要） |
| `enum_scope` | スコープサマリーと攻撃対象面の概要 |
osint — OSINTエンリッチメント（6テクニック）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `target` | string | エンリッチするIPアドレスまたはドメイン |
| `type` | `ip` \| `domain` | オプション — ターゲットタイプ（省略時は自動検出） |
| テクニック | 認証 | 説明 |
|-----------|------|-------------|
| `osint_shodan` | `SHODAN_API_KEY` | Shodanホスト検索 — オープンポート、バナー、脆弱性、OS |
| `osint_censys` | `CENSYS_API_ID` + `CENSYS_API_SECRET` | Censysホストデータ — サービス、TLS、自律システム |
| `osint_reverse_ip` | なし | リバースIP検索 — 同じIP上の他のドメイン |
| `osint_whois` | なし | WHOIS登録データ — レジストラ、日付、ネームサーバー |
| `osint_webarchive` | なし | Web Archive履歴 — 最初/最後のスナップショット、変更頻度 |
| `osint_virustotal` | `VIRUSTOTAL_API_KEY` | VirusTotalドメイン/IPレポート — 検出結果、カテゴリ、DNS |
analyze — パッシブフィンガープリント分析（3モード）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `type` | `headers` \| `html` \| `banner` | 分析するデータの種類 |
| `data` | string | 分析する生データ（ヘッダー、HTML、またはバナー出力を貼り付け） |
| モード | 説明 |
|--------|-------------|
| `fp_analyze_headers` | パッシブHTTPヘッダー分析 — トラフィックを送信せずにサーバー、フレームワーク、プロキシを検出 |
| `fp_analyze_html` | パッシブHTML分析 — ソースからの技術検出、フレームワーク識別 |
| `fp_analyze_banner` | パッシブバナー分析 — 生のバナーテキストからのサービス識別 |
correlate — マルチシグナル相関エンジン（7モード）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `type` | `consistency` \| `honeypot` \| `spoofing` \| `compare` \| `topology` \| `c2` \| `identify` | 相関モード |
| `signals` | object | 相関するフィンガープリントシグナル（モードにより異なる） |
| モード | 説明 |
|--------|-------------|
| `fp_consistency` | クロスレイヤーシグナル整合性チェック — TCP、TLS、HTTP、DNSのフィンガープリントが一致するか？ |
| `fp_honeypot` | ハニーポット検出 — 不可能なサービスの組み合わせと動作異常をチェック |
| `fp_spoofing` | スプーフィング検出 — サーバーヘッダーと実際の動作の不一致を特定 |
| `fp_compare` | 2つのホストのフィンガープリントプロファイルの並列比較 |
| `fp_topology` | インフラトポロジーマッピング — CDN、ロードバランサー、リバースプロキシチェーン |
| `fp_c2` | JARM、TLS、HTTP、タイミング相関によるC2フレームワーク検出 |
| `fp_identify` | 既知のシグネチャデータベースに対するハッシュベースの識別 |
meta — サーバー設定とデータ（3モード）
| パラメータ | 型 | 説明 |
|-----------|------|-------------|
| `category` | string | オプション — カテゴリでフィルター |
| モード | 説明 |
|--------|-------------|
| `fp_sources` | 設定とAPIキーステータスを含むすべての利用可能なデータソースの一覧 |
| `fp_config` | サーバー設定 — バージョン、ロードされたプロバイダー、テクニック数 |
| `fp_signatures` | シグネチャデータベース一覧 — JARM、バナー、WAF、アプリケーションシグネチャ |
---
### CLI使用法
```bash
# 利用可能なすべてのツールとテクニックを一覧表示
npx fingerprint-mcp --list
# 任意のツールを直接実行
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 '{}'
# OSINTツール（APIキーが必要）
SHODAN_API_KEY=your-key npx fingerprint-mcp --tool osint '{"target":"203.0.113.42","type":"ip"}'
```
---
## データソース（21）
| ソース | 認証 | 提供するもの |
|--------|------|-------------|
| TCPプローブ | なし | ポートスキャン、バナー取得、サービス検出 |
| TLS/SSL分析 | なし | 証明書解析、JARMフィンガープリンティング、JA4X、暗号列挙、SNIテスト |
| SSHプローブ | なし | プロトコルバージョン、アルゴリズム監査、ソフトウェア検出 |
| HTTP分析 | なし | ヘッダーフィンガープリンティング、faviconハッシュ、cookie分析、メソッド列挙、CORS |
| Web検出 | なし | 技術検出、アナリティクス、ソースマップ、WebSocket、GraphQL、SPAフレームワーク |
| パス発見 | なし | 機密ファイル、git漏洩、デバッグエンドポイント、APIバージョン、robots.txt |
| DNS解決 | なし | レコード列挙、メール認証分析、SaaS検出、サーバーフィンガープリンティング |
| WAF/CDN検出 | なし | WAF識別、CDN検出、WAFフィンガープリンティング |
| タイミング分析 | なし | レスポンスタイミングベースライン、クロックスキュー検出 |
| HTTP/2 & HTTP/3 | なし | HTTP/2検出とフィンガープリンティング、HTTP/3 Alt-Svc発見 |
| SMTPプローブ | なし | SMTPバナー分析、STARTTLS検査 |
| IoT/組み込み | なし | IoTデバイス検出、UPnP/SSDP発見 |
| アプリケーション検出 | なし | CMS、フレームワーク、eコマースプラットフォーム識別 |
| サービスプローブ | なし | MySQL、PostgreSQL、Redis、FTP、VNC/RDPフィンガープリンティング |
| インフラ検出 | なし | クラウドプロバイダー、ホスティングプロバイダー、CDN識別 |
| 相関エンジン | なし | シグナル整合性、ハニーポット検出、スプーフィング検出、トポロジーマッピング |
| 識別エンジン | なし | ハッシュベースの識別、C2検出、シグネチャマッチング |
| [Shodan](https://www.shodan.io) | `SHODAN_API_KEY` | ホストインテリジェンス — オープンポート、バナー、脆弱性、OS検出 |
| [Censys](https://censys.io) | `CENSYS_API_ID` | ホストデータ — サービス、TLS証明書、自律システム情報 |
| [SecurityTrails](https://securitytrails.com) | `SECURITYTRAILS_API_KEY` | WAFオリジン発見、パッシブDNS履歴、過去のレコード |
| [VirusTotal](https://www.virustotal.com) | `VIRUSTOTAL_API_KEY` | ドメイン/IPレピュテーション、検出結果、DNS履歴、カテゴリ |
---
## アーキテクチャ
```
src/
index.ts # CLIエントリーポイント（--help、--list、--tool、stdioサーバー）
protocol/
mcp-server.ts # MCPサーバーセットアップ（stdioトランスポート）
tools.ts # ツールレジストリ — 13のコンポジットツールすべてをここで登録
types/
index.ts # 共有型（ToolDef、ToolContext、ToolResult）
utils/
rate-limiter.ts # プロバイダーごとのレートリミッター
cache.ts # APIレスポンス用TTLキャッシュ
require-key.ts # APIキー検証ヘルパー
murmurhash3.ts # faviconハッシュ用MurmurHash3
composite/ # 13のコンポジットツールオーケストレーター
recon.ts # 完全リコンオーケストレーター（quick/standard/deep）
scan-ports.ts # ポートスキャンコンポジット
scan-tls.ts # TLS分析コンポジット
scan-dns.ts # DNSインテリジェンスコンポジット
scan-http.ts # HTTPフィンガープリンティングコンポジット
scan-paths.ts # パス発見コンポジット
scan-waf.ts # WAF/CDN検出コンポジット
scan-services.ts # サービスプローブコンポジット
analyze.ts # パッシブ分析コンポジット
correlate.ts # 相関エンジンコンポジット
enumerate.ts # スコープ拡張コンポジット
osint.ts # OSINTエンリッチメントコンポジット
meta.ts # サーバーメタコンポジット
helpers.ts # 共有コンポジットヘルパー
tcp/ # TCPプローブテクニック（3）
tls/ # TLS/SSL分析テクニック（8）
ssh/ # SSHプローブテクニック（3）
http/ # HTTPフィンガープリンティングテクニック（16）
web/ # Web技術検出テクニック（9）
path/ # パス発見テクニック（5）
dns/ # DNSインテリジェンステクニック（7）
waf/ # WAF/CDN検出テクニック（4）
timing/ # タイミング分析テクニック（2）
h2/ # HTTP/2 & HTTP/3テクニック（3）
smtp/ # SMTPプローブテクニック（2）
iot/ # IoT/組み込み検出テクニック（2）
app/ # アプリケーション検出テクニック（3）
service/ # サービスプローブテクニック（5）
infra/ # インフラ検出テクニック（3）
correlation/ # 相関エンジン（5）
identify/ # 識別エンジン（3）
passive/ # パッシブ分析（3）
osint/ # OSINTエンリッチメントテクニック（6）
enum/ # 列挙テクニック（8）
meta/ # メタツール（3）
data/ # シグネチャデータベースとパターンライブラリ
jarm-signatures.ts # 既知のJARMフィンガープリント（C2、サーバー、CDN）
waf-signatures.ts # WAF検出シグネチャ
service-banners.ts # サービスバナーパターン
tech-patterns.ts # 技術検出パターン
favicon-hashes.ts # 既知のfavicon MurmurHash3値
c2-signatures.ts # C2フレームワークシグネチャ
... # 15以上のシグネチャ/パターンデータベース
```
**設計上の決定：**
- **13のコンポジットツール、103のテクニック** — エージェントは高レベルツール（`recon`、`scan_tls`、`scan_http`）を呼び出します。各コンポジットは複数の低レベルテクニックをオーケストレーションし、相関された結果を返します。これにより粒度を維持しながらツール呼び出しのオーバーヘッドを削減します。
- **21プロバイダー、1サーバー** — すべてのフィンガープリンティングレイヤーが独立したモジュールです。コンポジットオーケストレーターがコンテキストと深度に基づいてテクニックを選択します。
- **アクティブ優先、OSINTはオプション** — 80以上のテクニックがAPIキーなしでターゲットを直接プローブして動作します。OSINTプロバイダー（Shodan、Censys、VirusTotal、SecurityTrails）はエンリッチメントを追加しますが、決して必須ではありません。
- **プロバイダーごとのレートリミッター** — 各プロバイダーが独自の`RateLimiter`インスタンスを持ちます。アクティブプローブは検出を避けるためレート制限され、OSINT APIはそれぞれのクォータに合わせて調整されています。
- **TTLキャッシュ** — DNSレコード（10分）、OSINT結果（15分）、CTログ（30分）がキャッシュされ、マルチツールワークフロー中の冗長な検索を回避します。
- **グレースフルデグラデーション** — 不足しているAPIキーがサーバーをクラッシュさせることはありません。OSINTツールは説明的なメッセージを返します：「Shodanホスト検索を有効にするにはSHODAN_API_KEYを設定してください。」
- **3つの依存関係** — `@modelcontextprotocol/sdk`、`zod`、`cheerio`。すべてのネットワークI/Oはネイティブの`fetch()`とNode.jsの`net`/`tls`/`dns`モジュール経由です。nmapなし、外部バイナリなし。
---
## 制限事項
- OSINTツール（Shodan、Censys、VirusTotal、SecurityTrails）はそれぞれのテクニックにAPIキーが必要
- Censys無料プランは月250クエリに制限
- VirusTotal無料プランは日500クエリに制限
- ポートスキャンはTCPコネクト（SYNスキャンではない）を使用 — nmapより隠密性が低いがroot権限は不要
- JARMフィンガープリンティングはターゲットへの直接TCPアクセスが必要（ファイアウォールによりブロックされる場合あり）
- UPnP/SSDP発見はローカルネットワークでのみ動作
- サービスプローブ（MySQL、PostgreSQL、Redis）は接続するが認証しない
- サブドメイン列挙はCTログとパッシブソースに依存（ブルートフォースなし）
- macOS / Linuxでテスト済み（Windowsは未テスト）
---
## MCPセキュリティスイートの一部
| プロジェクト | ドメイン | ツール |
|------------|---------|--------|
| [hackbrowser-mcp](https://github.com/badchars/hackbrowser-mcp) | ブラウザベースのセキュリティテスト | 39ツール、Firefox、インジェクションテスト |
| [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) | クラウドセキュリティ（AWS/Azure/GCP） | 38ツール、60以上のチェック |
| [github-security-mcp](https://github.com/badchars/github-security-mcp) | GitHubセキュリティ態勢 | 39ツール、45チェック |
| [cve-mcp](https://github.com/badchars/cve-mcp) | 脆弱性インテリジェンス | 23ツール、5ソース |
| [osint-mcp-server](https://github.com/badchars/osint-mcp-server) | OSINTとリコネサンス | 37ツール、12ソース |
| [darknet-mcp-server](https://github.com/badchars/darknet-mcp-server) | ダークウェブと脅威インテリジェンス | 66ツール、16ソース |
| **fingerprint-mcp** | **ユニバーサルデジタルフィンガープリンティング** | **13ツール、103テクニック、21プロバイダー** |
---
認可されたセキュリティテストと評価にのみ使用してください。
ターゲットに対してフィンガープリンティングを実行する前に、必ず適切な認可を得てください。
AGPL-3.0ライセンス • Bun + TypeScriptで構築