VirusTotal

VirusTotal MCP

公式 VirusTotal MCP サーバーを利用すると、エージェントがリンクを開いたり、ダウンロードしたファイルを実行したり、不審なインフラを調査したりする前に、脅威インテリジェンスを提供できます。vt-mcp は MCP クライアントを VTAI に接続し、ファイル、URL、ドメイン、IP アドレスのレポート、ファイルとネットワークの分析の送信、送信結果の復元に対応します。

現在のアクセス制限の範囲内で、無料の VTAI サービスを利用できます。独自の VirusTotal API キーは不要です。

OAuth でリモート接続する

互換性のあるリモート MCP クライアントで https://ai.virustotal.com/mcp を使用します。VTAI アカウントでサインインし、接続の権限を承認してください。ローカルへの Python のインストール、固定トークン、個人用 VirusTotal API キーは必要ありません。

Claude Code：プラグインをインストールする

公式プラグインには、OAuth 接続、脅威インテリジェンスのスキル、モデルが生成した base64 を使わないローカルファイルのアップロードが含まれています。

claude plugin marketplace add VirusTotal/virustotal-mcp
claude plugin install virustotal@virustotal

Claude Code 2.1.283 以降と、PATH に設定された Node.js 22 以降が必要です。Node.js 22 と 24 はプラグインの CI で検証済みです。プラグインには https://ai.virustotal.com/mcp が含まれています。

既存の手動接続をプラグインに置き換える場合は、削除する前に 移行と復元のガイド をお読みください。不確かな送信は、まず元の接続を通じて復元してください。この方法を選ぶ場合は、動作する手動接続を維持してください。

新しいセッションを開始するか、/reload-plugins を使用してから、必要に応じて /mcp を実行し、ブラウザーでサインインを完了します。プラグインには MCP 接続がすでに含まれているため、重複して追加しないでください。プラグインのセットアップ、ファイルへのアクセス、認証情報名の保護をご覧ください。

Claude Code の代替方法：Node.js を使わない手動 HTTP 接続

ローカルアップロードフックを使わずにレポートを参照する場合は、直接接続を使用します。

claude mcp add --transport http virustotal https://ai.virustotal.com/mcp

Claude Code を開き、/mcp を実行して virustotal を選択し、ブラウザーでのサインインを完了します。Claude Code の OAuth 手順とVirusTotal の接続ガイドをご覧ください。この方法かプラグインのどちらかを選択してください。サーバーを追加しただけでは設定は完了しません。認証を完了してツールを呼び出し、接続が動作することを確認してください。

OAuth 接続では、サインイン中の VTAI アカウントの無料枠を共有し、各接続で承認された権限を使用します。既存の Agent Token は、これまでの権限と利用枠を維持します。クライアントで設定可能な HTTP ヘッダーが必要な場合は、OAuth ではなく、保護された Authorization: Bearer または x-apikey の認証情報を 1 つ使用してください。その他のローカルクライアントでは、以下のstdio インストールを利用できます。

クライアントを接続する

1. 互換性のあるリモートクライアントでは、MCP URL を使って OAuth で接続します。それ以外の場合は、既存の VTAI Agent Token を再利用するか、新しく作成してください。
2. stdio の場合は、~/.config/vt-mcp/token のように、自分だけが読み取れるファイルにトークンを保存します。MCP サーバーの環境変数 VTAI_TOKEN_FILE にそのパスを設定し、コマンドを vt-mcp に設定してください。ファイルにはトークンのみを記載し、トークン自体をチャット、コマンドの引数、プロジェクトファイルに記載しないでください。
3. クライアントごとのセットアップ手順に従い、クライアントを再起動または再接続して、利用可能なツールを確認してください。 | クライアント | 設定 | |---|---| | Antigravity CLI (agy) | MCP とスキルを含むプラグイン、ローカル stdio、またはネイティブ OAuth の手順 | | Claude Code | ローカルファイルのアップロードに対応した OAuth プラグイン、HTTP、またはローカル stdio | | Codex | HTTP、またはローカル stdio | | ChatGPT | 公開済みの VirusTotal プラグインをインストール · 接続ガイド | | Cursor | HTTP の手順 | | GitHub Copilot 搭載の VS Code | HTTP の手順 | | GitHub Copilot CLI | HTTP OAuth の手順、またはローカル stdio | | Devin CLI | HTTP OAuth の手順、またはローカル stdio | | Windsurf / Devin Desktop | Cascade の HTTP 手順 | | Antigravity IDE | ローカル stdio の設定、またはネイティブ OAuth の手順 | | Gemini CLI | OAuth 拡張機能をインストール | | Gemini Apps | カスタム MCP 接続と、任意でインポート可能なスキルを利用できます。Google アカウントおよび地域での提供状況により利用できない場合があります。ホスト型ワークフローの検証は完了していません | | Grok Build | プラグインを手動でインストール；OAuth、レポート、更新を検証済み | | Kimi Code | プラグインを手動でインストール；外部モデルで OAuth、レポート、プロアクティブな更新を検証済み |

GitHub Copilot CLI と Devin CLI のリモート OAuth 設定は、それぞれの公式ドキュメントに従います。どちらのクライアントでも、OAuth 認証を使用した VirusTotal ツールのワークフローはまだ検証されていません。

Qwen Code、Mistral Vibe Work、Grok web、xAI Responses API のその他のリモートクライアント向け設定手順と、それぞれの検証上の制限については、こちらをご覧ください。 Qwen Code 0.25.1 には、VTAI との間で OAuth 認証情報の保存に関する既知の互換性問題があります。ブラウザーでの同意だけでは接続は完了しません。 クライアント検証ガイドでは、文書化された設定、ローカルのトランスポートチェック、モデルを使って実行したワークフローを区別しています。レシピは、すべてのクライアントで完全に検証済みであることを示すものではありません。他のエージェントも、同じ MCP エンドポイントまたはVTAI API を直接利用できます。

ChatGPT では、公開されている VirusTotal プラグインをインストールし、求められたら Google で接続してから、新しいチャットで @VirusTotal を選択します。公開プラグインには開発者モードは不要ですが、アカウントとワークスペースのポリシーは引き続き適用されます。接続ガイドには、別途用意されたカスタムアプリの代替手段と検証上の制限が記載されています。初回の OAuth 同意、IP レポート、自動トークン更新は、2026-09-24 に個別に検証しました。公開されていることは、すべてのワークフローが検証済みであることを意味しません。

最初のクエリでは、エージェントに次のように依頼してください。

VirusTotal を使って、virustotal.com のドメインレポートを取得してください。情報源、解析日、検出状況、レポートへのリンクを表示してください。

ChatGPT では、プロンプトの先頭に @VirusTotal を付けてください。レポートの検索でローカルファイルを読み取ったりアップロードしたりすることはありません。レポートが見つからない場合は不明のままです。検出数がゼロであっても、安全であることの証明にはなりません。

ローカルの stdio 用にインストールする

ローカルの stdio では、uvをインストールして、次を実行してください。

uv tool install --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version

ローカルの MCP サーバーは Linux、macOS、Windows に対応しており、両方のファイル送信ツールを利用できます。Windows での送信レシートにはローカルの NTFS ストレージが必要です。ネットワーク共有と再解析ポイントは拒否されます。別途提供される vt-mcp guard コマンドは引き続き Linux のみで利用できます。

クライアントを自動設定するには、セットアップガイドで Agy、Claude Code、Codex のいずれかを選び、Agent Token の代替手段を開いてオペレーティングシステムを選択してください。インストーラーは、所有者のみがアクセスできる POSIX 権限または Windows ユーザーのみの ACL でトークンを保護します。

このコマンドは、公式 PyPI インデックスからパッケージを取得し、分離されたツール環境にインストールします。Python 3.12 以降が必要です。vt-mcp を MCP クライアントの PATH に通すか、実行ファイルの絶対パスを使用してください。パッケージはクライアントの設定を変更しません。

既存の接続を維持する

セットアップガイドでクライアントのAgent Tokenの代替手段を開くと、設定済みのトランスポートを確認し、新しいトークンを作成せずにセットアップ管理対象のインストールを更新できます。アクセスチェックでは、クエリの割り当てを消費せずに GET /api/v3/agents/me/access を使用します。実際のレポートクエリでは割り当てを消費します。更新後はクライアントを再起動してください。アクセスや設定のチェックでは、ツールの実行もモデルの動作の保証も行いません。

手動でインストールした vt-mcp 実行ファイルをクライアントが実行している場合は、その環境をアップグレードしてください。

uv tool install --upgrade --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version

uvx ... vt-mcp==<version> で設定されたクライアントでは、インストール済みの実行ファイルとは独立して、その固定バージョンが使用されます。バージョン指定を更新するか、セットアップガイドを使用してください。ホストされた HTTP 接続ではデプロイ済みのサーバーを使用するため、ローカルパッケージのアップグレードは不要です。既存のトークンと送信レシートはそのまま保持してください。

レポート未検出、割り当て超過、一時的なサービスエラーには、next_steps とドキュメントへのリンクが含まれます。レポートが見つからない場合、ファイルまたはインジケーターは不明のままです。そのハッシュまたは値を確認してください。レポートの検索によって、送信や再解析が許可されることはありません。以下の共有に関するガイダンスに従い、ユーザーが明示的にその操作を求めた場合にのみ送信ツールを使用してください。ネットワーク操作を意図した場合は、ファイルの SHA256 または新しい UUIDv4 の request_id を保持し、その識別子を使って復旧してください。割り当て超過または一時的なサービスエラーが発生した場合は、retry_after_seconds があるときはそれに従い、認証情報を保持して、短い間隔での再試行を避けてください。不確かな送信を自動的に再実行したり、そのリクエスト ID を置き換えたりしないでください。まずレシートを使って復旧してください。

Antigravity IDE

エージェントパネルで MCP Servers → Manage MCP Servers → View raw config を開き、既存の設定に次のエントリを統合します。

{
  "mcpServers": {
    "virustotal": {
      "command": "vt-mcp",
      "args": [],
      "env": {
        "VTAI_TOKEN_FILE": "~/.config/vt-mcp/token"
      }
    }
  }
}

IDE が vt-mcp を見つけられない場合は、実行ファイルの絶対パスを指定してから、再読み込みしてツールを確認してください。IDE の stdio レポート検索は、記載されているクライアント検証で実施済みです。Antigravity plugin では、2026-10-02 に Antigravity CLI 1.2.14/1.2.15 でブラウザー OAuth、ドメインレポート、取り消しが完了しました。手動でのネイティブ OAuth 手順 は個別にはテストしていません。この CLI の結果は、IDE での OAuth、更新、ファイルの送信を検証するものではありません。OAuth を使用すると、未検証の HTTP 認証情報変数の展開に依存せずに済みます。Antigravity MCP の設定を参照してください。

ソースアーカイブには、Qwen Code、Kimi Code、OpenCode の手順も含まれています。それぞれのドキュメントでは、設定の調査とネイティブのツール呼び出しを区別しています。モデルプロバイダーがサポートされているだけでは、MCP クライアントとの互換性は確認できません。

ツール

ツール	目的
get_file_report(hash)	MD5、SHA-1、SHA-256 を指定して、既存のレポートを取得します。
get_url_report(url)	HTTP(S) URL の既存のレポートを取得します。
get_domain_report(domain)	ドメインの脅威情報を取得します。スキーム、パス、ポートは指定しません。
get_ip_report(ip)	IPv4 または IPv6 アドレス 1 件の脅威情報を取得します。
submit_file(sha256, content_base64)	標準分析のため、許可を得たバイト列を送信します。デコード後のサイズは最大 24,000,000 バイトです。
submit_attachment(file)	**ホスト型 HTTP アダプター：**公開 HTTPS ダウンロード URL から元のファイルを送信します。サイズは最大 24,000,000 バイトです。復元用に SHA256 を返します。
submit_url(url, request_id)	HTTP(S) URL の標準分析をリクエストします。呼び出す前に、新しい UUIDv4 リクエスト ID を保存してください。
reanalyze_domain(domain, request_id)	保存済みのリクエスト ID を使って、ドメインの再分析をリクエストします。
reanalyze_ip(ip, request_id)	保存済みのリクエスト ID を使って、IP アドレスの再分析をリクエストします。
get_submission(sha256=None, request_id=None)	ファイルハッシュまたはネットワークリクエスト ID のいずれか一方だけを指定して、所有する受付結果を復元します。
get_analysis(analysis_id, request_id=None)	登録済みの分析結果を読み取ります。操作を区別するには、ネットワーク受付結果のリクエスト ID を渡してください。
submit_local_file(path, expected_sha256=None)	**ローカル stdio 専用：**通常ファイルのコピーを送信します。サイズは最大 32,000,000 バイトです。期待するダイジェストを指定した場合は、コピーとの一致が必要です。

HTTP と stdio の両方で、共通の 10 個のツールを利用できます。ホスト型バックエンドでは、クライアントに依存しない添付ファイルの仕様に基づく submit_attachment が追加され、リモートツールは 11 個になります。元のファイルには公開 HTTPS URL が必要です。ネイティブの添付ファイル転送の可否はクライアントによって異なります。既存のホストファイルオブジェクトも引き続き使用できます。ローカル stdio では代わりに submit_local_file が追加され、ローカルツールは 11 個になります。リモートサーバーからデバイス上のパスを読み取ることはできません。ローカルファイルへのアクセスは、vt-mcp の実行アカウントと、MCP ホストで設定された権限によって制限されます。

ユーザーから明示的に依頼されたファイルの提供では、以下の共有ガイダンスに従って、許可を得たバイト列を送信してください。別途ハッシュ検索を行う必要はありません。VTAI はバイト列を検証してからハッシュを確認し、アップロードを許可するのはファイルが存在しないことが確認された場合のみです。新しいファイルの提供と、所有する受付結果の復元には、クエリ枠を消費しません。ファイルがすでに登録されている場合、VTAI はアップロードせず、既存のレポートを返す前にクエリを 1 件消費します。クエリ枠を使い切っている場合は、レポートを返さず、アップロードも行わずにエラーになります。明示的なレポート検索と get_analysis は、繰り返しを含め、呼び出しのたびにクエリ枠を消費します。ファイルワークフローのクエリ枠を参照してください。 不明なファイルの投稿には、固定された1分あたり20ファイル、UTC 1日あたり500ファイルの別枠があり、アップロード経路にかかわらず、各 Agent Token ID またはサインイン済み OAuth アカウントで共有されます。受け付けられた試行は、その後の処理状況が不確かな場合でもカウントされます。制限を回避するために、複数の ID やアカウントを作成しないでください。投稿の制限と再試行の動作を参照してください。

SHA256 と受付情報を保持してください。送信結果が不確かな場合は、POST を自動的に繰り返さず、get_submission で確認します。利用可能な場合は、get_analysis を使って登録済みの分析 ID を確認します。保留中、不明、エラーの各結果は区別してください。既存のレポートがあるからといって、新しい分析が完了したことにはなりません。

クライアントがファイルのバイトデータを送信できない場合は、まずファイルの SHA-256 を計算するか取得し、そのレポートを検索してください。アップロードせずに既存のレポートを利用してください。明示的に送信が要求され、レポートが存在しないことを確認できた場合に限り、VirusTotal ウェブアップロードの代替手段を利用できます。権限、割り当て量、サービスに関するエラーは、レポートが存在しないことの根拠にはなりません。この外部アップロードでは VTAI の受付情報は作成されません。同じ共有に関するガイダンスが適用されます。

ユーザーが明示的に要求したネットワーク分析では、送信ツールを呼び出す前に、正規形式の小文字 UUIDv4 を生成して保持してください。中断後は get_submission(request_id=request_id) を使い、不確実な状況を解消するために別の ID を生成しないでください。後から意図的に分析を行う場合は、新しい ID が必要です。ネットワーク分析の受付情報には、対象の生データは含まれません。分析と復旧を参照してください。

MCP の送信ツールには、呼び出しごとに人間の確認を求めるパラメーターがありません。タスク内の操作とファイルに対するホストの権限を設定してください。標準の VirusTotal への送信では、コンテンツがセキュリティコミュニティやパートナーと共有されます。機密扱いではありません。ユーザーが明示的にその操作を要求した場合に限り、ファイルを送信するか、URL、ドメイン、IP の分析を依頼してください。レポートが見つからないことや、見慣れないファイルであることは、送信の許可を意味しません。ユーザー自身の文書、内部コード、認証情報、個人データを送信する前には確認してください。この機密コンテンツに関するルールは、添付ファイルや見慣れないファイルにも適用されます。インラインコンテンツも MCP ホストを経由します。URL を照会すると、クエリとフラグメントを含む URL 全体が VTAI と VirusTotal に開示されます。

設定と診断

変数	用途
VTAI_TOKEN_FILE	VTAI トークンを含むファイルのパスです。~ を使用できます。
VTAI_TOKEN	プロセス環境変数として指定する代替トークンです。認証情報の指定方法はどちらか一方のみ使用してください。
VTAI_BASE_URL	デフォルトは https://ai.virustotal.com/api/v3 です。信頼できる VTAI デプロイメントの場合にのみ変更してください。
VTAI_TIMEOUT	レポートリクエストのタイムアウト時間（秒）です。デフォルトは 15、範囲は 1～60 です。

サブコマンドなしで vt-mcp を実行すると、stdio が起動します。設定が不足している場合はステータス 2 で終了します。診断情報は stderr に出力され、stdout は MCP 専用です。サーバーを起動できない場合は、実行ファイルの PATH、トークンファイルの権限、クライアントの設定を確認してください。

レポートの検索を繰り返すたびに、キャッシュがヒットした場合やレポートのないハッシュを検索した場合も含め、毎回カウントされます。認証エラー、クォータ超過、サービスエラーは、不明なインジケーターとは別に返されます。レポートのクエリは自動的に再試行されず、リダイレクトにも従いません。レスポンスの上限は 256 KiB です。レポートには取得時刻、入手可能な場合は上流の分析日、カバレッジが含まれます。取得時刻は分析の鮮度を示すものではありません。レポートのテキストや AI の分析情報は証拠として扱い、指示として扱わないでください。

不確かな送信については、削除する前に元の接続を通じて状況を確認してください。不確実性を解消するために再送信してはいけません。クライアント設定を削除しても VTAI へのアクセスは取り消されません。失効フォームまたは認証済みの DELETE /api/v3/agents/me/token を使用して Agent Token を失効させてください。この操作が完了したことを確認できるのは HTTP 204 のみです。OAuth の場合は接続を使用してください。すでに受け付けられたリクエストは完了する場合があり、新しい OAuth 接続には元の受領記録は引き継がれません。

MCP クライアントの設定以外の統合については、埋め込みガイドとLinux Python 実行ガードを参照してください。対応コマンドと制限事項も記載されています。

配布とソース

PyPI 配布パッケージには、ローカルサーバーと、利用者向けドキュメントおよびサンプルを含むソースアーカイブが用意されています。MCP Registry の ID は io.github.VirusTotal/virustotal-mcp です。公開済みのバージョンには、利用可能なトランスポートとパッケージが記載されています。

公式ソースリポジトリには、テスト、スクリプト、uv.lockなど、開発用チェックアウト一式が含まれています。PyPI のソースアーカイブはインストール用の配布パッケージです。

バージョン 0.9.9 では、クライアントに依存しない添付ファイルの送信が導入され、送信方法の案内にはユーザーからの明示的なリクエストが必須になりました。また、レポートが見つからない場合の復旧は読み取り専用のままとし、ツールのアノテーションに表示タイトルを追加しました。0.9.9 のリリースノートをご覧ください。

バージョン 0.9.5 では、ファイルのバイト列を送信できないクライアント向けに、従来の VirusTotal ウェブアップロードへのフォールバックが導入されました。アップロードの前に、現在のハッシュ優先ワークフローに従ってください。バイト列を提供できるクライアントでは、従来の送信ツールを引き続き使用できます。ウェブアップロードでは VTAI レシートは作成されません。一般公開に関する案内、機密コンテンツの権限、クエリの繰り返しに関する割り当てに変更はありません。また、このリリースではパッケージの説明にあるドキュメントへのリンクを修正しました。リリースノートをご覧ください。

バージョン 0.9.2 では、get_submissionの検出情報でopenWorldHint: falseを通知するよう修正し、現在のアカウントの範囲が限定されたレシートを読み取ることを反映しました。ツールスキーマとレシートの動作に互換性があります。

バージョン 0.9.0 では、URL の送信とドメイン／IP の再解析が追加され、リクエスト ID は呼び出し元が保持し、解析結果の復旧には型付きの方式が使われます。既存のファイル呼び出しとレシートの形式には互換性があります。OAuth によるネットワークへの書き込みには、個別のvt:network-analysis:write権限が必要です。既存の許可が自動的に拡張されることはありません。ネイティブ OS プロトコルのテストは、すべてのクライアントやモデルのワークフローを保証するものではありません。以前に公開された0.8.0 までの MIT リリースは、当時のファイルとライセンスをそのまま保持しています。

ライセンス

バージョン 0.8.1 以降はApache-2.0です。wheel とソースアーカイブの両方にLICENSE、NOTICE、LICENSES/MIT.txtが含まれています。MIT の通知には、以前の素材に対する帰属表示が保持されています。パッケージのライセンスによって、VirusTotal のインテリジェンスへのアクセス条件やアカウント権限が変わることはありません。依存関係には、それぞれ独自のライセンスが適用されます。

Google Open Source Software Vulnerability Rewards Programの対象となる条件は、Google Open Source Software Vulnerability Reward Program Rulesによって定められています。