MCP提交

Huntress MCP Server

Huntress API的MCP服务器，提供账户管理、组织管理、代理监控、事件报告等功能接口

安全监控 #安全监控 #API管理 #事件报告本地 .TypeScript

2.5分

2025-04-29 00:27:12

概述

安装

工具列表

内容详情

替代品

什么是Huntress API MCP Server?

Huntress API MCP Server是一个中间服务，允许您通过编程方式访问Huntress安全平台的各种功能。它简化了与Huntress API的交互，提供账户管理、安全事件监控、代理管理等工具。

如何使用Huntress API MCP Server?

您可以通过简单的API调用或配置好的MCP客户端来使用此服务。首先需要获取Huntress API密钥，然后安装并配置服务器即可开始使用。

适用场景

适用于需要自动化安全监控、批量管理多个组织/代理、定期生成安全报告或集成Huntress功能到现有工作流的场景。

主要功能

账户管理获取账户详细信息，包括订阅状态、许可信息等

组织管理列出和管理账户下的所有组织，获取组织详细信息

代理管理监控和管理安全代理，获取代理状态和详细信息

事件报告访问和分析安全事件报告，了解潜在威胁

摘要报告生成和查看安全活动摘要报告

账单报告访问账户账单和使用情况报告

优势与局限性

优势

简化了与Huntress API的复杂交互

内置自动化的速率限制管理(每分钟60次请求)

统一的错误处理和响应格式

支持多种安全相关功能

局限性

需要有效的Huntress API凭证

受Huntress API本身的速率限制

功能范围受限于Huntress API的能力

如何使用

获取API凭证从Huntress账户获取API Key和Secret

安装服务器通过Smithery自动安装或手动安装

配置环境变量设置HUNTRESS_API_KEY和HUNTRESS_API_SECRET

启动服务器构建并启动MCP服务器

使用案例

监控组织安全状态定期检查所有组织的安全事件和代理状态

生成月度安全报告自动收集并汇总月度安全活动数据

代理健康检查检查所有代理的在线状态和最后活动时间

常见问题

如何获取Huntress API凭证?登录Huntress账户，在API凭证部分生成新的Key和Secret。

遇到'Rate Limit Exceeded'错误怎么办?服务器内置了速率限制(60次/分钟)。建议实现请求队列或等待1分钟后重试。

可以同时管理多个Huntress账户吗?当前版本每个服务器实例只能配置一个账户的凭证。如需多账户支持，需要运行多个实例。

数据更新频率如何?数据实时性取决于Huntress API，通常有几分钟延迟。

猎人 API MCP 服务器

提供与 Huntress API 交互的工具的 Model Context Protocol (MCP) 服务器。此服务器为账户管理、组织管理、代理管理、事件报告、总结报告和更多功能提供了编程访问接口。

功能

账户信息检索
组织管理
代理管理与监控
事件报告访问
总结报告生成
费用报告访问
内置速率限制（每分钟 60 次请求）
错误处理和响应格式化

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Huntress API MCP 服务器以供 Claude Desktop 使用：

npx -y @smithery/cli install huntress-mcp-server --client claude

手动安装

克隆仓库
安装依赖项：

npm install

基于 .env.example 创建一个 .env 文件：

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

构建服务器：

npm run build

可用工具

账户管理

get_account_info: 获取当前账户信息

组织管理

list_organizations: 列出账户中的组织
get_organization: 获取特定组织的详细信息

代理管理

list_agents: 列出账户中的代理
get_agent: 获取特定代理的详细信息

事件报告

list_incident_reports: 列出事件报告
get_incident_report: 获取特定事件报告的详细信息

总结报告

list_summary_reports: 列出总结报告
get_summary_report: 获取特定总结报告的详细信息

费用报告

list_billing_reports: 列出费用报告
get_billing_report: 获取特定费用报告的详细信息

配置

服务器需要以下环境变量：

HUNTRESS_API_KEY: 您的 Huntress API Key
HUNTRESS_API_SECRET: 您的 Huntress API Secret Key

这些可以在您的 Huntress 账户的 <your_account_subdomain>.huntress.io 下的“API凭证”部分获取。

与 MCP 的使用

将以下配置添加到您的 MCP 设置中：

{
  "mcpServers": {
    "huntress": {
      "command": "node",
      "args": ["path/to/huntress-server/build/index.js"],
      "env": {
        "HUNTRESS_API_KEY": "your_api_key_here",
        "HUNTRESS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}