Binalyze AIR MCP サーバー
Binalyze AIR 用の**Model Context Protocol (MCP)**を実装する Node.js サーバー。AIR のデジタル フォレンジックおよびインシデント対応機能との自然言語による対話を可能にします。
✨ 特徴
資産管理- 組織内の資産を一覧表示します。
資産の詳細- ID によって特定の資産の詳細情報を取得します。
資産タスク- 特定の資産に関連付けられているすべてのタスクを ID で取得します。
取得プロファイル- 取得プロファイルを一覧表示します。
取得タスク- エンドポイントに証拠取得タスクを割り当てます。
イメージ取得タスク- エンドポイントにディスク イメージ取得タスクを割り当てます。
ベースライン取得- 特定のエンドポイントからベースライン データを取得して、参照ポイントを確立します。
ベースラインの比較- 特定のエンドポイントの複数のベースライン取得タスクを比較して、変更を識別します。
比較レポートの取得- 特定のエンドポイントとタスクの比較結果レポートを取得します。
取得プロファイルの作成- 特定の証拠/アーティファクト/ネットワーク設定を使用して新しい取得プロファイルを作成します。
取得アーティファクト- 証拠収集に使用可能なアーティファクトを一覧表示します。
取得証拠- 法医学データ収集に利用可能な証拠項目をリストします。
再起動タスク- 特定のエンドポイントに再起動タスクを割り当てます。
シャットダウン タスク- 特定のエンドポイントにシャットダウン タスクを割り当てます。
分離タスク- 特定のエンドポイントを分離または分離解除します。
ログ取得タスク- 特定のエンドポイントからログを取得します。
バージョン更新タスク- 特定のエンドポイントにバージョン更新タスクを割り当てます。
組織管理- 組織を一覧表示します。
ケース管理- 組織内のケースを一覧表示します。
ポリシー管理- 組織全体のセキュリティ ポリシーを確認します。
タスク管理- フォレンジック収集タスクとそのステータスを追跡します。
トリアージ ルール- 脅威検出のための YARA、Osquery、および Sigma ルールを表示します。
ユーザー管理- 組織内のユーザーを一覧表示します。
ドローン アナライザー- サポートされているオペレーティング システムで利用可能なドローン アナライザーを表示します。
監査ログのエクスポート- 監査ログのエクスポートを開始します。
監査ログの一覧表示- システムからの監査ログを表示します。
アセットのアンインストール- データを消去せずに、フィルターに基づいて特定のアセットをアンインストールします。
資産の消去とアンインストール- フィルターに基づいてデータを消去し、特定の資産をアンインストールします。
アセットにタグを追加- フィルターに基づいて特定のアセットにタグを追加します。
アセットからタグを削除- フィルターに基づいて特定のアセットからタグを削除します。
自動資産タグ付け- 特定の条件に基づいて資産に自動的にタグを付けるルールを作成および更新します。
自動資産タグの一覧表示- 既存の自動資産タグ ルールをすべて一覧表示します。
自動資産タグの詳細を取得- ID によって特定の自動資産タグ ルールの詳細情報を取得します。
自動資産タグの削除- ID によって特定の自動資産タグ ルールを削除します。
自動タグ付けを開始- 特定のフィルター条件に一致するアセットの自動タグ付けプロセスを開始します。
電子情報開示パターン- さまざまなファイル タイプを検出するために使用できる電子情報開示パターンを一覧表示します。
ポリシー管理- 組織内のポリシーを一覧表示、作成、更新、削除します。
ポリシー一致統計- さまざまな基準に基づいて、資産に適用されるポリシーを確認します。
タスク割り当て管理- タスクの割り当てを表示および管理します。
Related MCP server: Node Omnibus MCP Server
概要
このMCPサーバーは**、大規模言語モデル(LLM)**とBinalyze AIRの間にブリッジを作成し、自然言語によるインタラクションを可能にします。コードを書いたり複雑なAPIを習得したりすることなく、デジタルフォレンジック環境に関する情報を取得できます。
🔑 APIトークンの要件
**重要:**認証にはAPIトークン
AIR_API_TOKEN必要です。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 buildClaude 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"
}
}
}
}カーソルとの使用
カーソル設定 > MCP に移動します
次の構成で新しい 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 での使用
**注意:**エディターでエージェント モードを有効にすることを忘れないでください。
ワンラインインストールコマンド
クロード
npx -y @smithery/cli@latest install @binalyze/air-mcp --client claude --key {smithery_key}カーソル
npx -y @smithery/cli@latest install @binalyze/air-mcp --client cursor --key {smithery_key}ウィンドサーフィン
npx -y @smithery/cli@latest install@rapidappio/rapidapp-mcp --client windsurf --key {smithery_key}VSコード
npx -y @smithery/cli@latest install @binalyze/air-mcp --client vscode --key {smithery_key}または、VSCode の Magic Link オプションを使用します。
使い方
Claude Desktop または任意の MCP クライアントでは、自然言語コマンドを使用できます。
指示 | 説明 |
| すべての管理対象/管理対象外エンドポイントを OS、プラットフォーム情報とともに表示します |
| 特定の資産に関する詳細情報を表示します |
| 特定の資産に関連付けられたすべてのタスクを表示します |
| 利用可能な取得プロファイルを表示します |
| 証拠や成果物を含む特定の取得プロファイルに関する詳細情報を表示します。 |
| 証拠収集に利用可能なすべてのアーティファクトをプラットフォームとカテゴリ別に表示します |
| プラットフォームとカテゴリ別に整理された、フォレンジックデータ収集に利用可能なすべての証拠項目を表示します。 |
| 指定されたエンドポイントに証拠取得タスクを割り当てます |
| 特定のエンドポイントとボリュームにディスクイメージ取得タスクを割り当て、指定されたリポジトリに保存します。 |
| 指定された構成で新しい取得プロファイルを作成します |
| 特定のエンドポイントに再起動タスクを割り当てます |
| 特定のエンドポイントにシャットダウンタスクを割り当てます |
| 特定のエンドポイントに分離タスクを割り当てます |
| 特定のエンドポイントからの分離を削除します |
| 特定のエンドポイントにログ取得タスクを割り当てます |
| 特定のエンドポイントにバージョン更新タスクを割り当てます |
| 環境内のすべての組織を表示します |
| ケースをステータスと作成時間とともに表示します |
| セキュリティポリシーと収集ポリシーを表示します |
| すべてのタスクとそのステータスを一覧表示します |
| 脅威検出のためのYARA、OSQuery、Sigmaルールを表示します |
| システム内のすべてのユーザーの詳細を表示します |
| サポートされているオペレーティングシステムで利用可能なドローンアナライザーを表示します |
| 監査ログのエクスポートを開始します。エクスポートはAIRサーバー上でバックグラウンドで実行されます。 |
| タイムスタンプ、ユーザー、アクション、エンティティなどの詳細を含む監査ログを表示します。 |
| データを消去せずに指定されたアセットをアンインストールします( |
| データを消去し、指定されたアセットをアンインストールします ( |
| 指定されたタグを対象のアセットに追加します( |
| 対象のアセットから指定されたタグを削除します( |
| 条件に基づいて資産に自動的にタグを付ける新しいルールを作成します。 |
| 既存の自動資産タグ ルールを新しい条件で更新します。 |
| 既存のすべての自動資産タグ ルールとその構成を一覧表示します。 |
| 特定の自動資産タグ ルールに関する詳細情報を表示します。 |
| 特定の自動資産タグ ルールを ID で削除します。 |
| 指定された条件に一致する Windows アセットの自動タグ付けプロセスを開始します。 |
| 指定されたケース ID の指定されたエンドポイントからベースライン データを取得します。 |
| 特定のエンドポイントの複数のベースライン取得タスクを比較して、変更を識別します。 |
| 特定のエンドポイントと比較タスクの比較結果レポートを取得します。 |
| ファイルタイプ検出に利用可能なすべての電子情報開示パターンを表示します |
| カスタム設定で新しいポリシーを作成します |
| 既存のポリシーを新しい設定で更新します |
| 特定のポリシーに関する詳細情報を表示します |
| ポリシー適用の順序を更新します |
| 各ポリシーに一致するエンドポイントの数を表示します |
| プラットフォーム別にフィルタリングされたポリシー一致を表示します |
| オフライン資産のポリシー一致を表示します |
| システムからポリシーを永久に削除します |
| 特定のタスクに関連付けられたすべての割り当てを表示します |
| 特定のタスクの割り当てをキャンセルします |
| タスクの割り当てを完全に削除します |
| 証拠の種類や構成など、特定のタスクに関する詳細情報を表示します。 |
| 指定されたIDの実行中のタスクをキャンセルします |
| 特定のタスクを完全に削除します |
取得アーティファクトの表示
証拠収集に使用できるすべての取得アーティファクトを一覧表示できます。
List all acquisition artifacts
Show me all available artifacts for Windows
What artifacts can be collected for evidence?これにより、取得タスク中に収集できる成果物の分類されたリストが、プラットフォーム (Windows、Linux、macOS など) およびグループ カテゴリ (サーバー、通信、クラウドなど) 別に表示されます。
取得証拠の閲覧
法医学データ収集に利用可能なすべての証拠項目を一覧表示できます。
List all acquisition evidences
Show me all available evidences for Windows
What evidences can be collected during an investigation?これにより、フォレンジック調査中に収集できる証拠項目の分類されたリストが、プラットフォーム (Windows、Linux、macOS など) およびグループ カテゴリ (システム、ネットワーク、メモリなど) 別に表示されます。
電子情報開示パターンの表示
ファイル タイプ検出に使用できるすべての電子情報開示パターンを一覧表示できます。
List all e-discovery patterns
Show me all file patterns for e-discovery
What file patterns are available for e-discovery?組織によるフィルタリング
組織 ID で結果をフィルタリングできます。
List all assets for organization 123
Show me all cases for organization 456
Get policies for organization 789
List tasks for organization 123
List triage rules for organization 123
List users for organization 123
Export audit logs for organization 0
List audit logs for organization 0資産の詳細を取得する
特定の資産に関する詳細情報を取得できます。
Get details for asset "bc906dea-f92d-46b3-87f2-a2fc36667f70"
Show me information about endpoint with ID "bc906dea-f92d-46b3-87f2-a2fc36667f70"資産タスクの取得
特定のアセットに関連付けられているすべてのタスクを取得できます。
Get tasks for asset "bc906dea-f92d-46b3-87f2-a2fc36667f70"
Show me the tasks assigned to endpoint with ID "bc906dea-f92d-46b3-87f2-a2fc36667f70"
What tasks are currently running on asset "bc906dea-f92d-46b3-87f2-a2fc36667f70"取得タスクの割り当て
証拠取得タスクを特定のエンドポイントに割り当てることができます。
Assign an acquisition task to endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd" using profile "full" for case "C-2022-0001"
Start an acquisition on endpoints ["id1", "id2"] with profile "memory" for case "C-2023-0045" with analyzers ["bha", "wsa"]画像取得タスクの割り当て
ディスク イメージ取得タスクを特定のエンドポイントとボリュームに割り当てることができます。
Assign an image acquisition task to endpoint "7a37cfdb-..." for volume "/dev/disk3s5" saving to repository "Q2gCVO..." with case ID "C-2024-0123"
Assign image task for endpoint "ep-id-1" volumes ["/dev/sda1", "/dev/sda2"] and endpoint "ep-id-2" volume "C:" to repository "repo-xyz"再起動タスクの割り当て
特定のエンドポイントに再起動タスクを割り当てることができます。
Reboot endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Assign a reboot task to endpoints ["id1", "id2"] for organization 123シャットダウンタスクの割り当て
シャットダウン タスクを特定のエンドポイントに割り当てることができます。
Shutdown endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Assign a shutdown task to endpoints ["id1", "id2"] for organization 123分離タスクの割り当て
特定のエンドポイントを分離したり分離解除したりできます。
Isolate endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Assign an isolation task to endpoints ["id1", "id2"] for organization 123
Unisolate endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd" (by setting enabled=false)
Assign an unisolation task to endpoints ["id1", "id2"] with enabled=falseログ取得タスクの割り当て
特定のエンドポイントからログを取得できます。
Retrieve logs from endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd" with organization ID 0
Assign a log retrieval task to endpoints ["id1", "id2"] for organization 123注: ログ取得タスクを割り当てる際は、必ず組織IDを指定してください。エンドポイントは指定された組織内に存在している必要があります。
バージョン更新タスクの割り当て
特定のエンドポイントにバージョン更新タスクを割り当てることができます。
Update version for endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Assign a version update task to endpoints ["id1", "id2"] for organization 123アセットのアンインストール
フィルターを使用すると、データを削除せずにアセットをアンインストールできます。アンインストールするアセットの正確なIDを、 filter.includedEndpointIdsで指定する必要があります。
Uninstall asset with ID "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Uninstall assets with IDs ["id1", "id2"] for organization 0資産の削除とアンインストール
フィルターを使用して、アセットデータをパージしたり、アセットをアンインストールしたりできます。パージおよびアンインストールするアセットの正確なIDを、 filter.includedEndpointIdsで指定する必要があります。
Purge and uninstall asset with ID "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Purge and uninstall assets with IDs ["id1", "id2"] for organization 0アセットにタグを追加する
フィルターを使用して、特定のアセットにタグを追加できます。タグを追加するアセットの正確なIDをfilter.includedEndpointIdsで指定し、 tags配列に少なくとも1つのタグを指定する必要があります。
Add tags ["important", "review-needed"] to asset with ID "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Add tag "critical" to assets with IDs ["id1", "id2"] for organization 0アセットからタグを削除する
フィルターを使用して、特定のアセットからタグを削除できます。タグを削除するアセットの正確なIDをfilter.includedEndpointIdsで指定し、 tags配列に少なくとも1つのタグを指定する必要があります。
Remove tags ["obsolete"] from asset with ID "0ccbb181-685c-4f1e-982a-6f7c7e88eadd"
Remove tag "needs-review" from assets with IDs ["id1", "id2"] for organization 0自動資産タグルールの作成
異なるオペレーティングシステム間で、条件に基づいてアセットを自動的にタグ付けするルールを定義できます。Linux、Windows、macOSのタグ名と条件を記述してください。
Create an auto asset tag named "Web Server"
- For Linux: if process "apache2" is running OR process "nginx" is running
- For Windows: if process "httpd.exe" is running OR process "nginx.exe" is running
- For macOS: if process "httpd" is running
Create auto asset tag "Domain Controller" if windows registry key "HKLM\\SYSTEM\\CurrentControlSet\\Services\\NTDS\\Parameters" exists自動資産タグの詳細を取得する
特定の自動資産タグ ルールに関する詳細情報を、ID で取得できます。
Get auto asset tag with ID "f6kEPhpqMNqJeHfi4RyxiWEm"
Show me details about the auto asset tag rule "f6kEPhpqMNqJeHfi4RyxiWEm"
Fetch information about auto asset tag "f6kEPhpqMNqJeHfi4RyxiWEm"自動資産タグの削除
自動資産タグ ルールは ID で削除できます。
Delete auto asset tag with ID "f6kEPhpqMNqJeHfi4RyxiWEm"
Remove the auto asset tag rule "f6kEPhpqMNqJeHfi4RyxiWEm"
Delete the auto asset tagging rule "f6kEPhpqMNqJeHfi4RyxiWEm"自動資産タグルールの一覧表示
設定されているすべての自動資産タグ ルールを一覧表示して、その ID、タグ、条件を確認できます。
List all auto asset tags
Show me the auto asset tag rules自動資産タグ付けプロセスの開始
特定のフィルター条件に一致するアセットに対して自動タグ付けプロセスを開始できます。
Start auto tagging for all Windows assets
Start tagging for managed Windows endpoints
Initiate auto tagging process for assets with platform "linux"
Start auto tagging for endpoints with IDs ["id1", "id2"]ベースラインの取得
ケースIDとフィルター条件を指定することで、特定のエンドポイントからベースラインデータを取得できます。ベースラインは、フォレンジック調査における比較のための基準点となります。
Acquire baseline for case "C-2022-001" from endpoints ["0ccbb181-685c-4f1e-982a-6f7c7e88eadd", "7a37cfdb-..."]
Get baseline data for case "C-2023-042" from all Windows endpoints
Acquire baseline for online endpoints with case ID "C-2024-099"
Collect baseline from managed endpoints with IDs ["id1", "id2", "id3"] for case "C-2024-100"ベースライン取得タスクの比較
特定のエンドポイントの複数のベースライン取得タスクを比較して、時間の経過に伴う変化や異なるシステム状態間の変化を識別できます。
Compare baselines for endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd" with task IDs ["task1", "task2"]
Compare baseline tasks ["task-id-1", "task-id-2", "task-id-3"] for endpoint "7a37cfdb-..."
Create baseline comparison between tasks "pre-update-task-id" and "post-update-task-id" for endpoint "bc906dea-..."比較レポートの取得
特定のエンドポイントと比較タスクの比較結果レポートを取得できます。
Get comparison report for endpoint "0ccbb181-685c-4f1e-982a-6f7c7e88eadd" and task "task1"
Show me the comparison result for endpoint "7a37cfdb-..." and task "comparison-task-id"
Download the baseline comparison report for endpoint "bc906dea-..." task "task-xyz"ポリシーの作成
特定のストレージ、圧縮、セキュリティ設定を使用して新しいポリシーを作成できます。
Create a policy named "Dev Policy" with:
Windows storage at C:\Binalyze\AIR
Linux storage at /opt/binalyze/air
macOS storage at /opt/binalyze/air
Compression enabled
Encryption enable with password "secure123"タスクの割り当ての表示
タスクの割り当てのステータスを確認できます。
Show me all assignments for task abc-123-456