简介

一个实现了模型上下文协议（MCP）的 Node.js 服务器，它能够通过自然语言与 Binalyze AIR 的数字取证和事件响应功能进行交互。

简介

一个实现了模型上下文协议（MCP）的 Node.js 服务器，它能够通过自然语言与 Binalyze AIR 的数字取证和事件响应功能进行交互。

Binalyze AIR MCP 服务器

这是一个使用 Node.js 实现的 Model Context Protocol (MCP) 服务器，用于 Binalyze AIR，使用户能够通过自然语言与 AIR 的数字取证和事件响应功能进行交互。

✨ 特性

• 资产管理 - 列出组织中的资产。
• 采集配置文件 - 列出采集配置文件。
• 组织管理 - 列出组织。
• 案件管理 - 列出组织中的案件。
• 策略管理 - 查看整个组织的安全策略。
• 任务管理 - 跟踪取证收集任务及其状态。
• 分诊规则 - 查看用于威胁检测的 YARA、Osquery 和 Sigma 规则。
• 用户管理 - 列出组织中的用户。
• 无人机分析器 - 查看支持的操作系统的可用无人机分析器。

概览

此 MCP 服务器在 大型语言模型 (LLMs) 和 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 设置 > 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 客户端中，您可以使用自然语言命令：

按组织筛选

你可以通过组织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)

找到3条分诊规则： corewebshell_detection: core.webshell_detection (引擎: yara, 搜索范围: 两者) fireeye-sunburst-countermeasures: FireEye Sunburst Countermeasures (引擎: yara, 搜索范围: 两者) fireeye-red-team-tools-countermeasures: FireEye Red Team Tools Countermeasures (引擎: yara, 搜索范围: 两者)

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

找到20个无人机分析器： bha: 浏览器历史记录分析器 (支持的操作系统: Windows, 默认启用: 是) wsa: 通用WebShell分析器 (支持的操作系统: Windows, Linux, macOS, 默认启用: 是)

工具列表

• list_assets: List all assets in the system

• list_acquisition_profiles: List all acquisition profiles in the system

• list_organizations: List all organizations in the system

• list_cases: List all cases in the system

• list_policies: List all policies in the system

• list_tasks: List all tasks in the system

• list_triage_rules: List all triage rules in the system

• list_users: List all users in the system

服务配置

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

来源

• 来源：github
• 链接：https://github.com/binalyze/air-mcp