Huntress API MCP Server

基本能力

产品定位

Huntress API MCP Server 是一个中间件服务，旨在为开发者提供程序化访问Huntress安全平台功能的接口。

核心功能

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

适用场景

• 自动化安全监控系统
• 批量管理Huntress账户和组织
• 集成Huntress数据到其他安全工具
• 定期生成安全报告

工具列表

账户管理

• 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: 获取特定账单报告的详细信息

常见问题解答

• 速率限制：每分钟最多60个请求，采用滑动窗口机制
• 错误处理：包括无效API凭证、速率限制超出、无效请求参数等
• 配置要求：需要设置Huntress API Key和Secret

使用教程

使用依赖

• Node.js环境
• npm包管理器

安装教程

通过Smithery安装

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

手动安装

1. 克隆仓库
2. 安装依赖:

npm install

1. 创建.env文件:

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

1. 构建服务器:

npm run build

调试方式

1. 确保环境变量正确设置
2. 运行服务器:

node path/to/huntress-server/build/index.js

1. 检查API响应和错误日志

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。