Binalyze AIR MCP Server

Binalyze AIR MCP サーバー

Binalyze AIR のデジタルフォレンジックおよびインシデント対応機能を自然言語で利用できる、**Model Context Protocol（MCP）**を実装した Node.js サーバーです。

✨ 機能

• アセット管理 - 組織内のアセットを一覧表示します。
• アセットの詳細 - IDを指定して、特定のアセットの詳細情報を取得します。
• アセットのタスク - IDを指定して、特定のアセットに関連付けられたすべてのタスクを取得します。
• 取得プロファイル - 取得プロファイルを一覧表示します。
• 取得タスク - エンドポイントに証拠取得タスクを割り当てます。
• イメージ取得タスク - エンドポイントにディスクイメージ取得タスクを割り当てます。
• ベースライン取得 - 特定のエンドポイントからベースラインデータを取得し、基準点を確立します。
• ベースラインの比較 - 特定のエンドポイントに対する複数のベースライン取得タスクを比較して、変更を特定します。
• 比較レポートの取得 - 特定のエンドポイントとタスクの比較結果レポートを取得します。
• 取得プロファイルの作成 - 特定の証拠／アーティファクト／ネットワーク設定を使用して、新しい取得プロファイルを作成します。
• 取得アーティファクト - 証拠収集に利用できるアーティファクトを一覧表示します。
• 取得証拠 - フォレンジックデータ収集に利用できる証拠項目を一覧表示します。
• 再起動タスク - 特定のエンドポイントに再起動タスクを割り当てます。
• シャットダウンタスク - 特定のエンドポイントにシャットダウンタスクを割り当てます。
• 隔離タスク - 特定のエンドポイントを隔離、または隔離解除します。
• ログ取得タスク - 特定のエンドポイントからログを取得します。
• バージョン更新タスク - 特定のエンドポイントにバージョン更新タスクを割り当てます。
• 組織管理 - 組織を一覧表示します。
• ケース管理 - 組織内のケースを一覧表示します。
• ポリシー管理 - 組織全体のセキュリティポリシーを確認します。
• タスク管理 - フォレンジック収集タスクとそのステータスを追跡します。
• トリアージルール - 脅威検出用のYARA、Osquery、Sigmaルールを表示します。
• ユーザー管理 - 組織内のユーザーを一覧表示します。
• ユーザーの詳細 - IDを指定して、特定のユーザーの詳細情報を取得します。
• ドローンアナライザー - 対応オペレーティングシステムとともに、利用可能なドローンアナライザーを表示します。
• 監査ログのエクスポート - 監査ログのエクスポートを開始します。
• 監査ログの一覧表示 - システムの監査ログを表示します。
• アセットのアンインストール - データを消去せずに、フィルターに基づいて特定のアセットをアンインストールします。
• アセットの消去とアンインストール - フィルターに基づいてデータを消去し、特定のアセットをアンインストールします。
• アセットへのタグの追加 - フィルターに基づいて、特定のアセットにタグを追加します。
• アセットからのタグの削除 - フィルターに基づいて、特定のアセットからタグを削除します。
• アセットの自動タグ付け - 特定の条件に基づいてアセットに自動でタグを付けるルールを作成、更新します。
• アセット自動タグの一覧表示 - 既存のアセット自動タグルールをすべて一覧表示します。
• アセット自動タグの詳細取得 - IDを指定して、特定のアセット自動タグルールの詳細情報を取得します。
• アセット自動タグの削除 - IDを指定して、特定のアセット自動タグルールを削除します。
• 自動タグ付けの開始 - 特定のフィルター条件に一致するアセットの自動タグ付けプロセスを開始します。
• 電子情報開示パターン - さまざまなファイル形式を検出するために利用可能な電子情報開示パターンを一覧表示します。
• ポリシー管理 - 組織内のポリシーを一覧表示、作成、更新、削除します。
• ポリシー一致統計 - さまざまな条件に基づいて、どのポリシーがアセットに適用されるかを確認します。
• タスク割り当て管理 - タスクの割り当てを表示、管理します。
• トリアージルール管理 - 脅威検出用のトリアージルールを一覧表示、作成、更新、削除します。
• トリアージタグ管理 - 脅威検出用のトリアージタグを一覧表示、作成します。
• トリアージルールの検証 - 作成せずにトリアージルールの構文を検証します。
• トリアージタスクの割り当て - フィルター条件に基づいて、エンドポイントにトリアージタスクを割り当てます。
• ケースへのメモの追加 - IDを指定して、特定のケースにメモを追加します。
• ケース内のメモの更新 - 特定のケースにある既存のメモを更新します。
• ケースからのメモの削除 - IDを指定して、ケースからメモを削除します。
• ケースのエクスポート - システムからケースデータをエクスポートします。
• ケースメモのエクスポート - IDを指定して、特定のケースのメモをエクスポートします。
• ケースエンドポイントのエクスポート - IDを指定して、特定のケースのエンドポイントをエクスポートします。
• ケースアクティビティのエクスポート - IDを指定して、特定のケースのアクティビティをエクスポートします。
• ケースの作成 - システムに新しいケースを作成します。
• ケースの更新 - IDを指定して、既存のケースを更新します。
• IDによるケースの取得 - IDを指定して、特定のケースの詳細情報を取得します。
• IDによるケースのクローズ - IDを指定して、特定のケースをクローズします。
• IDによるケースのオープン - IDを指定して、特定のケースをオープンします。
• IDによるケースのアーカイブ - IDを指定して、特定のケースをアーカイブします。
• ケース名の確認 - ケース名がすでに使用されているか確認します。
• ケースアクティビティの取得 - IDを指定して、特定のケースのアクティビティ履歴を取得します。
• ケースエンドポイントの取得 - IDを指定して、特定のケースに関連付けられたすべてのエンドポイントを取得します。
• IDによるケースタスクの取得 - IDを指定して、特定のケースに関連付けられたすべてのタスクを取得します。
• ケースユーザーの取得 - IDを指定して、特定のケースに関連付けられたすべてのユーザーを取得します。
• ケースからのエンドポイントの削除 - 指定されたフィルターに基づいて、ケースからエンドポイントを削除します。
• ケースからのタスク割り当ての削除 - 特定のタスク割り当てをケースから削除します。
• ケースへのタスク割り当てのインポート - 特定のケースにタスク割り当てをインポートします。
• リポジトリの一覧表示 - 組織内のすべての証拠リポジトリを一覧表示します。
• SMBリポジトリの作成 - 新しいSMB証拠リポジトリを作成します。
• SMBリポジトリの更新 - 既存のSMB証拠リポジトリを更新します。
• SFTPリポジトリの作成 - 新しいSFTP証拠リポジトリを作成します。
• SFTPリポジトリの更新 - 既存のSFTP証拠リポジトリを更新します。
• FTPSリポジトリの作成 - 新しいFTPS証拠リポジトリを作成します。
• FTPSリポジトリの更新 - 既存のFTPS証拠リポジトリを更新します。
• FTPSリポジトリの検証 - 作成せずにFTPSリポジトリの設定を検証します。
• Azure Storageリポジトリの作成 - 新しいAzure Storage証拠リポジトリを作成します。
• Azure Storageリポジトリの更新 - 既存のAzure Storage証拠リポジトリを更新します。
• Azure Storageリポジトリの検証 - 作成せずにAzure Storageリポジトリの設定を検証します。
• Amazon S3リポジトリの作成 - 新しいAmazon S3証拠リポジトリを作成します。
• Amazon S3リポジトリの更新 - 既存のAmazon S3証拠リポジトリを更新します。
• Amazon S3リポジトリの検証 - 作成せずにAmazon S3リポジトリの設定を検証します。
• IDによるリポジトリの取得 - IDを指定して、特定の証拠リポジトリの詳細情報を取得します。
• リポジトリの削除 - IDを指定して、証拠リポジトリを削除します。
• ケースPPCのダウンロード - 特定のエンドポイントとタスクのPPCファイルをダウンロードします。
• タスクレポートのダウンロード - 特定のエンドポイントとタスクのタスクレポートをダウンロードします。
• レポートファイル情報の取得 - 特定のエンドポイントとタスクのPPCファイルに関する情報を取得します。
• 組織ユーザーの取得 - IDを指定して、特定の組織のユーザーを取得します。
• 組織へのユーザーの割り当て - 特定の組織にユーザーを割り当てます。
• 組織からのユーザーの削除 - 特定の組織からユーザーを削除します。
• 組織の作成 - 新しい組織を作成します。
• 組織の更新 - 既存の組織を更新します。
• IDによる組織の取得 - IDを指定して、特定の組織の詳細情報を取得します。
• 組織名の存在確認 - 組織名がシステムにすでに存在するか確認します。
• 共有可能なデプロイ情報の取得 - デプロイトークンを使用して、共有可能なデプロイに関する情報を取得します。
• 組織の共有可能なデプロイ設定の更新 - 組織の共有可能なデプロイ設定を更新します。
• 組織のデプロイトークンの更新 - 特定の組織のデプロイトークンを更新します。
• 組織の削除 - IDを指定して、組織を削除します。
• 組織へのタグの追加 - 組織にタグを追加します。
• 組織からのタグの削除 - 組織からタグを削除します。
• Webhookの呼び出し - 指定したパラメーターでWebhookを呼び出します。
• Webhookへのデータ送信 - Webhookにデータを送信します。
• タスク割り当ての取得 - IDを指定して、特定のタスクのすべての割り当てを取得します。
• バナーメッセージの更新 - システムのバナーメッセージ設定を更新します。

概要

この MCP サーバーは、**大規模言語モデル（LLM）**と Binalyze AIR の間にブリッジを構築し、自然言語での操作を可能にします。コードを書いたり、複雑な API を学習したりすることなく、デジタルフォレンジック環境に関する情報を取得できます。

🔑 API トークンの要件

重要： 認証には API トークンが必要です。AIR_API_TOKEN 環境変数を使用して設定してください。

📦 インストール

ローカル開発

# Clone the repository
git clone https://github.com/binalyze/air-mcp

# Change to the project directory
cd air-mcp

# Install dependencies
npm install

# Build the project
npm run build

Claude Desktop での使用

次の設定を Claude Desktop の設定ファイルに追加してください。

{
  "mcpServers": {
    "air-mcp": {
      "command": "npx",
      "args": ["-y", "@binalyze/air-mcp"],
      "env": {
        "AIR_HOST": "your-api-host.com",
        "AIR_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor での使用

1. Cursor Settings > MCP に移動します
2. 次の設定を使用して、新しい MCP サーバーを追加します。

   {
     "mcpServers": {
       "air-mcp": {
         "command": "npx",
         "args": ["-y", "@binalyze/air-mcp"],
         "env": {
           "AIR_HOST": "your-api-host.com",
           "AIR_API_TOKEN": "your-api-token"
         }
       }
     }
   }
   

🧩 Smithery での使用

注： エディターでエージェントモードを有効にすることを忘れないでください。

1 行で実行できるインストールコマンド

Claude

npx -y @smithery/cli@latest install @binalyze/air-mcp --client claude --key {smithery_key}

Cursor

npx -y @smithery/cli@latest install @binalyze/air-mcp --client cursor --key {smithery_key}

Windsurf

npx -y @smithery/cli@latest install@rapidappio/rapidapp-mcp --client windsurf --key {smithery_key}

VSCode

npx -y @smithery/cli@latest install @binalyze/air-mcp --client vscode --key {smithery_key}

または、VSCode の Magic Link オプションを使用してください。

使用方法

Claude Desktop または任意の MCP クライアントで、自然言語のコマンドを使用できます。

コマンド	説明
List all assets in the system	OS とプラットフォーム情報を含む、管理対象および管理対象外のすべてのエンドポイントを表示します
Get details about asset with ID "abc123"	特定のアセットの詳細情報を表示します
Get tasks for asset with ID "abc123"	特定のアセットに関連付けられたすべてのタスクを表示します
List all acquisition profiles	利用可能なすべての取得プロファイルを表示します
Get acquisition profile details by ID	証拠データとアーティファクトを含む、特定の取得プロファイルの詳細情報を表示します
List all acquisition artifacts	証拠収集に利用できるすべてのアーティファクトを、プラットフォームとカテゴリ別に表示します
List all acquisition evidences	フォレンジックデータ収集に利用できるすべての証拠項目を、プラットフォームとカテゴリ別に表示します
Assign an acquisition task to endpoint 123abc using profile "full" for case "C-2022-0001"	指定したエンドポイントに証拠取得タスクを割り当てます
Assign an image acquisition task to endpoint 123abc for volume /dev/sda1 saving to repository 456def	特定のエンドポイントとボリュームにディスクイメージ取得タスクを割り当て、指定したリポジトリに保存します
Create an acquisition profile named "My Custom Profile" with windows evidence ["clp"] and linux artifact ["apcl"]	指定した設定で新しい取得プロファイルを作成します
Reboot endpoint 123abc	特定のエンドポイントに再起動タスクを割り当てます
Shutdown endpoint 123abc	特定のエンドポイントにシャットダウンタスクを割り当てます
Isolate endpoint 123abc	特定のエンドポイントに隔離タスクを割り当てます
Unisolate endpoint 123abc	特定のエンドポイントの隔離を解除します
Retrieve logs from endpoint 123abc	特定のエンドポイントにログ取得タスクを割り当てます
Update version for endpoint 123abc	特定のエンドポイントにバージョン更新タスクを割り当てます
List all organizations	環境内のすべての組織を表示します
List all cases	ステータスと作成日時を含むケースを表示します
List all policies	セキュリティポリシーと収集ポリシーを表示します
List all tasks	ステータスを含むすべてのタスクを一覧表示します
List all triage rules	脅威検出用の YARA、OSQuery、Sigma ルールを表示します
List all users	システム内のすべてのユーザーの詳細を表示します
Get user by ID	ID を指定して特定のユーザーの詳細を取得します
List all drone analyzers	対応 OS を含む、利用可能なドローンアナライザーを表示します
Export audit logs	監査ログのエクスポートを開始します。エクスポートは AIR サーバー上でバックグラウンド実行されます。
List audit logs	タイムスタンプ、ユーザー、アクション、エンティティなどの詳細を含む監査ログを表示します
Uninstall asset with ID "endpoint-id"	指定したアセットをデータを消去せずにアンインストールします（filter.includedEndpointIds の指定が必要です）
Purge and uninstall asset with ID "endpoint-id"	データを消去して指定したアセットをアンインストールします（filter.includedEndpointIds の指定が必要です）
Add tags ["tag1", "tag2"] to asset with ID "endpoint-id"	対象のアセットに指定したタグを追加します（filter.includedEndpointIds と tags の指定が必要です）
Remove tags ["tag1"] from asset with ID "endpoint-id"	対象のアセットから指定したタグを削除します（filter.includedEndpointIds と tags の指定が必要です）
Create an auto asset tag named "Web Server"	条件に基づいてアセットに自動でタグを付ける新しいルールを作成します。
Update auto asset tag "fkkEPhpqMNqJeHfi4RyxiWEm" to have tag name "Updated Container" with linux process "containerd" running	新しい条件を指定して、既存の自動アセットタグルールを更新します。
List all auto asset tag rules	既存のすべての自動アセットタグルールを設定とともに一覧表示します。
Get auto asset tag with ID "f6kEPhpqMNqJeHfi4RyxiWEm"	特定の自動アセットタグルールの詳細情報を表示します。
Delete auto asset tag with ID "f6kEPhpqMNqJeHfi4RyxiWEm"	ID を指定して特定の自動アセットタグルールを削除します。
Start auto tagging for windows machines	指定した条件に一致する Windows アセットの自動タグ付け処理を開始します。
Acquire baseline for case "C-2022-001" from endpoints ["id1", "id2"]	指定したケース ID のために、指定したエンドポイントからベースラインデータを取得します。
Compare baselines for endpoint "id1" with task IDs ["task1", "task2"]	特定のエンドポイントについて複数のベースライン取得タスクを比較し、変更を特定します。
Get comparison report for endpoint "id1" and task "task1"	特定のエンドポイントと比較タスクの比較結果レポートを取得します。
List all e-discovery patterns	ファイル形式の検出に利用できるすべての e-discovery パターンを表示します
Create a policy named "Production Policy" with specific storage settings	カスタム設定で新しいポリシーを作成します
Update policy with ID "abc123"	既存のポリシーを新しい設定で更新します
Get policy details for ID "System"	特定のポリシーの詳細情報を表示します
Update policy priorities to ["policy1", "policy2", "policy3"]	ポリシーの適用順序を更新します
Show policy match statistics	各ポリシーに一致するエンドポイントの数を表示します
Get policy distribution for Windows endpoints	プラットフォームで絞り込んだポリシーの一致状況を表示します
Get policy match stats for offline endpoints	オフラインのアセットに対するポリシーの一致状況を表示します
Delete policy with ID "abc123"	システムからポリシーを完全に削除します
Get all assignments for task with ID "def456"	特定のタスクに関連付けられたすべての割り当てを表示します
Cancel task assignment with ID "xyz789"	特定のタスク割り当てをキャンセルします
Delete task assignment with ID "xyz789"	特定のタスク割り当てを完全に削除します
Get details about task with ID "40a9dc46-d401-4bd1-82d3-ca9cf97c9024"	証拠の種類と設定を含む、特定のタスクの詳細情報を表示します
Cancel task with ID "abc123"	指定した ID の実行中のタスクをキャンセルします
Delete task with ID "abc123"	特定のタスクを完全に削除します
Create triage rule named "My Rule"	新しいトリアージルールを作成します
List all triage tags	トリアージルールと、それに関連付けられたタグを操作できます
Create triage tag named "My Tag"	新しいトリアージタグを作成します
Update triage rule with ID "abc123"	既存のトリアージルールを更新します
Delete triage rule with ID "abc123"	トリアージルールを完全に削除します
Get triage rule with ID "abc123"	特定のトリアージルールの詳細を取得します
Validate triage rule syntax	作成せずにトリアージルールの構文を検証します
Assign triage task to endpoints with IDs ["id1", "id2"]	フィルター条件に基づいてエンドポイントにトリアージタスクを割り当てます
Add note to case with ID "C-2022-0002"	ID を指定して特定のケースにメモを追加します
Update note with ID "8d9baa16-9aa3-4e4f-a08e-a74341ce2f90" in case "C-2022-0002"	特定のケースにある既存のメモを更新します
Delete note with ID "8d9baa16-9aa3-4e4f-a08e-a74341ce2f90" from case "C-2022-0002"	ID を指定してケースから特定のメモを削除します
Export cases data	組織のケースデータのエクスポートを開始します
Export notes for case with ID "case123"	ID を指定して特定のケースのメモのエクスポートを開始します
Export endpoints for case with ID "case123"	ID を指定して特定のケースのエンドポイントのエクスポートを開始します
Export activities for case with ID "case123"	ID を指定して特定のケースのアクティビティのエクスポートを開始します
Create a new case named "Incident Response"	システムに新しいケースを作成します
Update case with ID "C-2022-0003" to have name "Updated Case"	ID を指定して既存のケースを更新します
Get case with ID "C-2022-0003"	ID を指定して特定のケースの詳細を取得します
Close case with ID "C-2022-0003"	ID を指定して特定のケースをクローズします
Open case with ID "C-2022-0003"	ID を指定して特定のケースをオープンします
Archive case with ID "C-2022-0003"	ID を指定して特定のケースをアーカイブします
Change case owner with ID "C-2022-0003" to user with ID "user123"	ID を指定して特定のケースの所有者を変更します
Check if case name "Incident 2023-05" is available	ケース名がすでに使用されているか確認します
Get case activities for case with ID "C-2022-0003"	ID を指定して特定のケースのアクティビティ履歴を表示します
Get endpoints for case with ID "C-2022-0001"	ID を指定して特定のケースに関連付けられたすべてのエンドポイントを取得します
Get tasks for case with ID "C-2022-0001"	指定したケースに関連付けられたすべてのタスクを表示します
Get users for case with ID "C-2022-0001"	ID を指定して特定のケースに関連付けられたすべてのユーザーを取得します
Remove endpoints from case with ID "C-2022-0001"	指定したフィルターに基づいてケースからエンドポイントを削除します
Remove task assignment with ID "f04666c9-62c7-4cb0-8638-967f05eb7936" from case "C-2022-0001"	ケースから特定のタスク割り当てを削除します
Import task assignments to case with ID "C-2022-0001"	特定のケースにタスク割り当てをインポートします
List repositories	組織内のすべての証拠リポジトリを一覧表示します
Create SMB repository with name "My SMB Repository"	指定した認証情報で新しい SMB 証拠リポジトリを作成します
Update SMB repository with ID "abc123"	既存の SMB リポジトリの設定を更新します
Create SFTP repository with name "My SFTP Repository"	指定した認証情報で新しい SFTP 証拠リポジトリを作成します
Update SFTP repository with ID "abc123"	既存の SFTP リポジトリの設定を更新します
Validate FTPS repository configuration	FTPS リポジトリの設定を作成せずに検証します
Create Azure Storage repository with name "My Azure Storage Repository"	指定した認証情報で新しい Azure Storage 証拠リポジトリを作成します
Update Azure Storage repository with ID "abc123"	既存の Azure Storage リポジトリの設定を更新します
Validate Azure Storage repository with SAS URL	指定した SAS URL が Azure Storage へのアクセスに有効か確認します
Create a new Amazon S3 repository	新しい S3 バケットを証拠リポジトリとして設定します
Update Amazon S3 repository with ID "abc123"	既存の S3 リポジトリの設定を変更します
Validate Amazon S3 repository configuration	S3 の認証情報とバケットが有効か確認します
Get details about repository with ID "abc123"	特定の証拠リポジトリの詳細情報を表示します
Delete repository with ID "abc123"	特定の証拠リポジトリを削除します
Download PPC file for endpoint "ep-1" and task "task-1"	指定したエンドポイントとタスクの PPC ファイルをダウンロードします
Download task report for endpoint "123" and task "456"	指定したエンドポイントとタスクのタスクレポートをダウンロードします
Get report file information for endpoint "123" and task "456"	特定のエンドポイントとタスクの PPC ファイルに関する情報を取得します
Get users for organization with ID "2"	指定した組織に所属するすべてのユーザーを表示します
Assign users with IDs ["user1", "user2"] to organization "123"	指定した組織にユーザーを割り当てます
Remove user with ID "user1" from organization "123"	指定した組織からユーザーを削除します
Create organization with name "My Organization" and contact information	指定した名前と連絡先情報で新しい組織を作成します
Update organization with ID "123"	既存の組織を新しい設定で更新します
Get details about organization with ID 2	特定の組織の詳細情報を表示します
Check if organization name "My Organization" already exists	組織名がすでに使用されているか確認します
Get shareable deployment information using deployment token "token123"	デプロイトークンを使用して共有可能なデプロイメント情報を取得します
Update organization shareable deployment with ID "123" to be enabled	組織の共有可能なデプロイメント設定を更新します
Update deployment token for organization with ID 2	特定の組織のデプロイトークンを更新します
Delete organization with ID "123"	システムから組織を完全に削除します
Add tags to organization with ID "123"	組織にタグを追加します
Delete tags ["tag1", "tag2" ] from organization with ID "123"	組織からタグを削除します
Call webhook with slug "air-generic-url-webhook" and data "192.168.1.100" and token "token123"	指定したパラメーターで Webhook を呼び出します
Post data to webhook with slug "air-generic-url-webhook"	指定したデータを Webhook に POST リクエストで送信します
Get task assignments for task with ID "task123"	ID を指定して特定のタスクのすべての割り当てを取得します
Update banner message	システムのバナーメッセージ設定を更新します