Huntress MCP服务器
  ](https://nodejs.org/)
A. 模型上下文协议（MCP） 为AI助手提供结构化访问的服务器 女猎手 网络安全平台数据和操作。
注： 该项目由以下人员维护 Wyre技术.
快速开始
克劳德桌面版 --下载、打开、完成：
- 下载
huntress-mcp.mcpb从 最新版本 - 打开文件（双击或拖动到Claude Desktop）
- 提示时输入Huntress凭据（API密钥、API机密）
无需终端，无需JSON编辑，无需安装Node.js。
克劳德代码（CLI）：
claude mcp add huntress-mcp \
-e HUNTRESS_API_KEY=your-api-key \
-e HUNTRESS_API_SECRET=your-api-secret \
-- npx -y github:wyre-technology/huntress-mcp看 安装 Docker和源代码方法。
特性
- 🔌 MCP协议合规性：完全支持MCP资源和工具
- 🛡️ 全面的安全保障：涵盖代理、组织、事件、升级、计费、信号和用户的工具
- 🔍 决策树导航：从以下内容开始
huntress_navigate探索域，然后动态加载特定于域的工具 - 📝 CRUD操作：为组织、成员资格、事件等创建、读取、更新、删除操作
- 🔒 安全认证：具有Huntress API凭据的HTTP基本身份验证
- 🌐 双重运输：支持stdio（本地）和HTTP流式传输（远程/Docker）
- 📦 MCPB包装：桌面客户端通过MCP Bundle一键安装
- 🐳 Docker就绪：具有HTTP传输和健康检查的容器化部署
- ⚡ 速率限制：内置速率限制器符合Huntress API限值（60 req/min）
- 📊 结构化日志记录：具有可配置级别的全面日志记录
目录
安装
选项1:MCPB捆绑包（克劳德桌面版）
最简单的方法——无需终端，无需JSON编辑，无需安装Node.js。
- 下载
huntress-mcp.mcpb从 最新版本 - 打开文件（双击或拖动到Claude Desktop）
- 提示时输入Huntress凭据（API密钥、API机密）
对于 克劳德代码（CLI），一个命令：
claude mcp add huntress-mcp \
-e HUNTRESS_API_KEY=your-api-key \
-e HUNTRESS_API_SECRET=your-api-secret \
-- npx -y github:wyre-technology/huntress-mcp选项2:Docker
docker compose up或者拉取预构建的图像：
docker run -d \
-e HUNTRESS_API_KEY=your-key \
-e HUNTRESS_API_SECRET=your-secret \
-p 8080:8080 \
ghcr.io/wyre-technology/huntress-mcp:latest选项3：来源
git clone https://github.com/wyre-technology/huntress-mcp.git
cd huntress-mcp
npm ci
npm run build配置
| 变量 | 描述 | 默认值 |
|---|---|---|
HUNTRESS_API_KEY | API公钥 | - |
HUNTRESS_API_SECRET | API密钥 | - |
MCP_TRANSPORT | 运输方式(stdio 或 http) | stdio |
MCP_HTTP_PORT | HTTP服务器端口 | 8080 |
AUTH_MODE | 身份验证模式(env 或 gateway) | env |
LOG_LEVEL | 日志级别(debug, info, warn, error) | info |
领域
服务器使用决策树导航。从...开始 huntress_navigate 要选择域，请执行以下操作：
| 域 | 工具 |
|---|---|
| 账户 | 获取帐户信息，获取当前演员 |
| 代理 | 列出代理，按ID获取代理 |
| 组织 | 列出、获取、创建、更新、删除组织 |
| 事件 | 事件报告（列表/获取/解决）、补救措施（列表/获得/批准/拒绝）、升级（列表/得到/解决） |
| 计费 | 账单报告、总结报告 |
| 信号 | 列出/获取安全信号 |
| 用户 | 成员CRUD（列表/获取/创建/更新/删除） |
Docker部署
看 用于完整配置。复制 .env.example 到 .env 并填写您的凭据：
cp .env.example .env
# Edit .env with your Huntress API credentials
docker compose up -d发展
npm ci
npm run build # Build the project
npm run dev # Watch mode
npm run test # Run tests
npm run lint # Type-check
npm run clean # Remove dist/测试
npm test # Run test suite
npm run test:watch # Watch mode贡献
看 贡献.md 作为指导方针。
许可证
Apache 2.0——版权所有WYRE技术