Dynamicendpoints Huntress MCP Server

🚀 獵人 API MCP 服務器

本項目是一個模型上下文協議（MCP）服務器，它提供了與 Huntress API 交互的工具。藉助該服務器，你能夠以編程方式訪問 Huntress 的各項功能，涵蓋賬戶管理、組織管理、代理管理、事故報告、摘要報告等多個方面。

🚀 快速開始

本服務器可讓你通過編程方式訪問 Huntress 功能，下面為你介紹使用前的準備工作。

✨ 主要特性

• 🔍 獲取賬戶信息
• 🏢 組織管理
• 🖥️ 代理管理和監控
• 📄 事故報告訪問
• 📊 摘要報告生成
• 💰 賬單報告訪問
• ⏱️ 內置速率限制（每分鐘 60 個請求）
• ❌ 錯誤處理和響應格式化

📦 安裝指南

按照以下步驟安裝本項目：

1. 克隆倉庫。
2. 安裝依賴：

npm install

3. 基於 .env.example 創建一個 .env 文件，並填入 API 密鑰和機密密鑰：

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

4. 構建服務器：

npm run build

💻 使用示例

可用工具

本服務器提供了一系列工具，用於不同功能的操作：

賬戶管理

• 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：獲取特定賬單報告的詳細信息。

使用 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_KEY：您的 Huntress API 密鑰。
• HUNTRESS_API_SECRET：您的 Huntress API 機密密鑰。 這些可以在您 Huntress 賬戶的 <your_account_subdomain>.huntress.io 下的 API 憑證部分獲取。

速率限制

服務器實現了 Huntress API 的每分鐘 60 個請求的速率限制（基於滑動窗口）。具體規則如下：

• 每個 60 秒時間段內最多隻能有 60 個請求。
• 窗口會滑動，因此如果第 1 個請求在 T0 提交，第 60 個請求在 T30 提交，則第 61 個請求必須等待直到 T60。

錯誤處理

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

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

📄 許可證

本項目採用 MIT 許可證，有關詳細信息，請參閱 LICENSE 文件。