Huntress

🚀 獵人 API MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，提供了與 Huntress API 交互的工具。藉助該服務器，你可以進行程序化訪問，實現賬戶管理、組織管理、代理管理、事件報告、摘要報告等諸多功能。

🚀 快速開始

本服務器可讓你輕鬆與 Huntress API 進行交互，實現各類管理和報告功能。你可以通過 Smithery 自動安裝，也能手動進行安裝配置。

✨ 主要特性

• 賬戶信息檢索：可獲取當前賬戶的詳細信息。
• 組織管理：支持列出賬戶中的所有組織，並獲取特定組織的詳細信息。
• 代理管理與監控：能夠列出賬戶中的所有代理，同時獲取特定代理的詳細信息。
• 事件報告訪問：可以列出事件報告，並獲取特定事件報告的詳細信息。
• 摘要報告生成：支持列出摘要報告，並獲取特定摘要報告的詳細信息。
• 費用報告訪問：可列出費用報告，並獲取特定費用報告的詳細信息。
• 內置速率限制：每分鐘限制60次請求，確保服務穩定。
• 錯誤處理和響應格式化：對多種錯誤場景進行處理，並對響應進行格式化。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 自動安裝 Huntress API MCP 服務器以用於 Claude 桌面版：

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 工具獲取賬戶信息的示例：

# 調用 get_account_info 工具獲取賬戶信息
# 假設已經配置好環境變量
node path/to/huntress-server/build/index.js get_account_info

高級用法

以下是使用 list_organizations 工具列出賬戶中所有組織的示例：

# 調用 list_organizations 工具列出所有組織
# 假設已經配置好環境變量
node path/to/huntress-server/build/index.js list_organizations

📚 詳細文檔

可用工具

賬戶管理

• 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 賬戶 <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，第60次請求在T30，則第61次請求必須等到T60。

錯誤處理

服務器處理了多種錯誤場景：

• 無效的 API 憑證。
• 超過速率限制。
• 無效的請求參數。
• API 響應錯誤。

📄 許可證

本項目採用 MIT License，詳情請參見 LICENSE 文件。