Binalyze AIR MCP 服务器

<p align="center"> <img src="./src/assets/bi-logo.png" alt="AIR Logo" width="180"/> </p>

一个为 Binalyze AIR 实现 模型上下文协议 (MCP) 的 Node.js 服务器，支持与 AIR 的数字取证和事件响应能力进行自然语言交互。

✨ 功能

• 资产管理 - 列出您组织中的资产。
• 采集配置文件 - 列出采集配置文件。
• 组织管理 - 列出组织。
• 案例管理 - 列出您组织中的案例。
• 策略管理 - 查看您组织中的安全策略。
• 任务管理 - 跟踪取证收集任务及其状态。
• Triage 规则 - 查看用于威胁检测的 YARA、Osquery 和 Sigma 规则。
• 用户管理 - 列出您组织中的用户。

概述

此 MCP 服务器在 大型语言模型 (LLM) 和 Binalyze AIR 之间创建桥梁，允许通过自然语言进行交互。无需编写代码或学习复杂的 API 即可检索有关您的数字取证环境的信息。

🔑 API 令牌要求

重要提示： 需要 API 令牌进行身份验证。 使用 AIR_API_TOKEN 环境变量设置它。

📦 安装

本地开发

# 克隆存储库
git clone https://github.com/binalyze/air-mcp

# 切换到项目目录
cd air-mcp

# 安装依赖项
npm install

# 构建项目
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 设置 > 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 一起使用

注意： 不要忘记在编辑器中激活代理模式。

一行安装命令

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	显示所有托管/非托管端点，包括操作系统、平台信息
List all acquisition profiles	显示可用的采集配置文件
List all organizations	显示环境中的所有组织
List all cases	显示案例，包括状态和创建时间
List all policies	显示安全和收集策略
List all tasks	列出所有任务及其状态
List all triage rules	显示用于威胁检测的 YARA 和 Sigma 规则
List all users	显示系统中所有用户的详细信息

按组织筛选

您可以按组织 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

响应示例

Found 3 assets:
a1b2c3d4: Win10-Workstation1 (Windows - Windows 10 Pro)
e5f6g7h8: Ubuntu-Server1 (Linux - Ubuntu 20.04)
i9j0k1l2: MacBook-Pro (macOS - macOS 12.3)

Found 3 triage rules: corewebshell_detection: core.webshell_detection (Engine: yara, Search In: both) fireeye-sunburst-countermeasures: FireEye Sunburst Countermeasures (Engine: yara, Search In: both) fireeye-red-team-tools-countermeasures: FireEye Red Team Tools Countermeasures (Engine: yara, Search In: both)

Found 1 user:
DtmrCWrK1o7m0bqVasdzg6Ia: demo@binalyze.com (demo@binalyze.com)