Air-MCP 工具
一个实现了模型上下文协议（MCP）的 Node.js 服务器，它能够通过自然语言与 Binalyze AIR 的数字取证和事件响应功能进行交互。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"air-mcp": {
"args": [
"-y",
"@binalyze/air-mcp"
],
"command": "npx",
"env": {
"AIR_API_TOKEN": "your-api-token",
"AIR_HOST": "your-api-host.com"
}
}
}
}该服务需要配置环境变量：AIR_API_TOKEN、AIR_HOST
可用工具 （8 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_assets 1 个参数
List all assets in the system
该工具无需必填参数，直接调用即可
list_acquisition_profiles 2 个参数
List all acquisition profiles in the system
该工具无需必填参数，直接调用即可
list_organizations
List all organizations in the system
该工具无需必填参数，直接调用即可
list_cases 1 个参数
List all cases in the system
该工具无需必填参数，直接调用即可
list_policies 1 个参数
List all policies in the system
该工具无需必填参数，直接调用即可
list_tasks 1 个参数
List all tasks in the system
该工具无需必填参数，直接调用即可
list_triage_rules 1 个参数
List all triage rules in the system
该工具无需必填参数，直接调用即可
list_users 1 个参数
List all users in the system
该工具无需必填参数，直接调用即可
服务介绍
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 一起使用
- 导航到 Cursor 设置 > 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 一起使用
注意： 不要忘记在编辑器中激活代理模式。
一键安装命令
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、OSQuery和Sigma规则 |
List all users |
显示系统中所有用户及其详细信息 |
List all drone analyzers |
显示支持的操作系统的无人机分析器 |
按组织筛选
你可以通过组织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, 默认启用: 是)
