Huntress API MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Huntress API 交互的工具。 该服务器支持对 Huntress 功能的编程访问，包括帐户管理、组织管理、代理管理、事件报告等。

<a href="https://glama.ai/mcp/servers/hry99k6xc2"><img width="380" height="200" src="https://glama.ai/mcp/servers/hry99k6xc2/badge" alt="Huntress-MCP-Server MCP server" /></a>

功能

• 帐户信息检索
• 组织管理
• 代理管理和监控
• 事件报告访问
• 摘要报告生成
• 账单报告访问
• 内置速率限制（每分钟 60 个请求）
• 错误处理和响应格式化

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Huntress API MCP 服务器：

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

手动安装

1. 克隆存储库
2. 安装依赖项：

npm install

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

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

4. 构建服务器：

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 密钥
• HUNTRESS_API_SECRET: 您的 Huntress API 密钥

这些可以从您的 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"
      }
    }
  }
}

速率限制

该服务器实现了 Huntress API 的速率限制，即在滑动窗口上每分钟 60 个请求。 这意味着：

• 在任何 60 秒的时间段内，最多可以发出 60 个请求
• 窗口滑动，因此如果在 T0 发出请求 1，在 T30 发出请求 60，则请求 61 必须等到 T60

错误处理

服务器处理各种错误情况：

• 无效的 API 凭据
• 超过速率限制
• 无效的请求参数
• API 响应错误

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件