Huntress MCP Server

🚀 獵人 API MCP 服務器

本服務器基於 Model Context Protocol (MCP)，提供了與 Huntress API 交互的工具。它為賬戶管理、組織管理、代理管理、事件報告、總結報告等功能提供了編程訪問接口，極大地方便了相關操作。

🚀 快速開始

本服務器提供了便捷的編程訪問接口，可用於賬戶管理、組織管理、代理管理等多種功能。下面將為您詳細介紹其安裝和使用方法。

✨ 主要特性

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

📦 安裝指南

通過 Smithery 安裝

若要通過 Smithery 自動安裝 Huntress API MCP 服務器以供 Claude Desktop 使用，可執行以下命令：

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

組織管理

# 列出賬戶中的組織
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_API_KEY：您的 Huntress API Key
• HUNTRESS_API_SECRET：您的 Huntress API Secret Key

這些可以在您的 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 次請求。
• 窗口是動態移動的，例如：如果請求 1 發佈在 T0，請求 60 發佈在 T30，則請求 61 必須等待直到 T60。

錯誤處理

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

• 無效的 API 憑證。
• 請求超時。
• 網絡連接問題。

📄 許可證

[在此處指定許可證信息，如果適用]

此文檔為您提供了 Huntress API MCP 服務器的完整功能概述和使用指南。如需進一步幫助或詳細信息，請參考相關文檔或聯繫支持團隊。