w0h1v/mcp-virustotal

クイックスタート · 道具・ HTTP · セキュリティ・ トラブルシューティング · ドキュメンタリー

mcp-virustotalは、AIエージェントにVirusTotal v3 APIへのアクセスを提供するMCPサーバーです。エージェントにハッシュ、URL、IPまたはドメインを渡すと、検出レポートとアナリストが検討する関係性(連絡したホスト、削除されたファイル、解決、脅威アクター)が返ってきます。

[!注] VirusTotalやGoogleとは無関係な独立プロジェクト>。ご自身のVirusTotal APIキーが必要です。

ハイライト

• 関係付きレポート。 ファイル、URL、IPおよびドメインレポートは、クオータを節約するために1回のバッチ?relationships=呼び出しでキー関係を取得します。
• キャッシュを優先します。 get_url_report はキャッシュされたVirusTotalレポートを返し、キャッシュミス時のみスキャンを送信します。
• Pivotツール。 VTIスタイルの修飾子([type:peexe positives:5+])を用いたコーパス検索、統合されたサンドボックス挙動の要約、そして脅威アクターおよびマルウェアファミリーのコレクション。
• フルリレーションシップページング。 ファイル、URL、IP、ドメインをまたぐ100+のリレーションシップタイプ、カーソルページ付き。
• **2つのトランスポート。**デスクトップクライアント用は標準、共有サービスはHTTPストリーミング。
• Tested. Node 20、22、24のCI上でフォーマットおよびAPI層のユニットテストが実施されます。

Quickstart · Tools · HTTP · Security · Troubleshooting · Docs

mcp-virustotal is an MCP server that gives AI agents access to the VirusTotal v3 API. Hand your agent a hash, URL, IP or domain and get back the detection report plus the relationships an analyst would pivot on: contacted hosts, dropped files, resolutions, threat actors.

[!NOTE] Independent project, not affiliated with VirusTotal or Google. You need your own VirusTotal API key.

Highlights

• Reports with relationships. File, URL, IP and domain reports fetch key relationships in one batched ?relationships= call to save quota.
• Cache first. get_url_report returns the cached VirusTotal report and only submits a scan on a cache miss.
• Pivot tools. Corpus search with VTI-style modifiers (type:peexe positives:5+), merged sandbox behaviour summaries, and threat-actor and malware-family collections.
• Full relationship paging. 100+ relationship types across files, URLs, IPs and domains, with cursor pagination.
• Two transports. stdio for desktop clients, HTTP streaming for a shared service.
• Tested. Unit tests for the formatters and API layer run in CI on Node 20, 22 and 24.

How it works

flowchart LR
    A["AI agent(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-virustotal"]
    S -->|"validate input,HTTPS + API key"| V["VirusTotal v3 API"]
    V -->|"JSON"| S
    S -->|"formatted report text"| A

Quickstart

Requirements: Node.js 20 or newer and a VirusTotal API key.

# Claude Code
claude mcp add --transport stdio --env VIRUSTOTAL_API_KEY=your-key virustotal -- npx -y @burtthecoder/mcp-virustotal