Huntress-MCP-Server

女猎手 API MCP 服务器

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

特征

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

安装

通过 Smithery 安装

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

手动安装

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

3. 根据.env.example创建.env文件：

4. 构建服务器：

可用工具

账户管理

• 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 Credentials 下获取。

与 MCP 一起使用

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

速率限制

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

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

错误处理

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

• API 凭证无效
• 超出速率限制
• 请求参数无效
• API 响应错误

执照

MIT 许可证 - 详情请参阅许可证文件