Huntress API MCP Server

此 MCP 服务器提供与 Huntress API 的程序化交互，支持账户管理、组织管理、代理监控和事件报告等功能。

快速安装

自动安装 (推荐)

通过 Smithery 安装到 Claude Desktop：

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

手动安装

1. 克隆仓库并安装依赖

   npm install
   

2. 配置环境变量 (参考 .env.example)

   HUNTRESS_API_KEY=your_api_key_here
   HUNTRESS_API_SECRET=your_api_secret_here
   

3. 构建服务器

   npm run build
   

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"
      }
    }
  }
}

主要功能

• 账户管理: 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

注意事项

• API 速率限制: 每分钟最多 60 个请求 (滑动窗口)
• 错误处理包括: 无效凭证、速率限制超出、无效参数和 API 响应错误

许可证

MIT 许可证 (详见 LICENSE 文件)