Servidor MCP de la API de Huntress

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API de Huntress. Este servidor permite el acceso programático a las funciones de Huntress, como la gestión de cuentas, la gestión de organizaciones, la gestión de agentes, los informes de incidentes y más.

Características

• Recuperación de información de la cuenta

• Gestión de la organización

• Gestión y monitorización de agentes

• Acceso a informes de incidentes

• Generación de informes resumidos

• Acceso a informes de facturación

• Limitación de velocidad incorporada (60 solicitudes por minuto)

• Manejo de errores y formato de respuesta

Related MCP server: mcp-server-aistor

Instalación

Instalación mediante herrería

Para instalar Huntress API MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

1. Clonar el repositorio

2. Instalar dependencias:

npm install

3. Cree un archivo .env basado en .env.example :

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

4. Construir el servidor:

npm run build

Herramientas disponibles

Gestión de cuentas

• get_account_info : Obtener información sobre la cuenta actual

Gestión de la organización

• list_organizations : Lista las organizaciones en la cuenta

• get_organization : Obtener detalles de una organización específica

Gestión de agentes

• list_agents : Lista los agentes en la cuenta

• get_agent : Obtener detalles de un agente específico

Informes de incidentes

• list_incident_reports : Lista de informes de incidentes

• get_incident_report : Obtener detalles de un informe de incidente específico

Informes resumidos

• list_summary_reports : Informes de resumen de lista

• get_summary_report : Obtener detalles de un informe de resumen específico

Informes de facturación

• list_billing_reports : Lista de informes de facturación

• get_billing_report : Obtener detalles de un informe de facturación específico

Configuración

El servidor requiere las siguientes variables de entorno:

• HUNTRESS_API_KEY : Su clave API de Huntress

• HUNTRESS_API_SECRET : Su clave secreta de la API de Huntress

Estos se pueden obtener de su cuenta de Huntress en <your_account_subdomain>.huntress.io en Credenciales de API.

Uso con MCP

Agregue la siguiente configuración a la configuración de su 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"
      }
    }
  }
}

Limitación de velocidad

El servidor implementa la limitación de velocidad de la API de Huntress de 60 solicitudes por minuto en una ventana deslizante. Esto significa:

• No se pueden realizar más de 60 solicitudes en un período de 60 segundos.

• La ventana se desliza, por lo que si la solicitud 1 se realiza en T0 y la solicitud 60 en T30, la solicitud 61 debe esperar hasta T60

Manejo de errores

El servidor gestiona varios escenarios de error:

• Credenciales de API no válidas

• Límite de velocidad excedido

• Parámetros de solicitud no válidos

• Errores de respuesta de la API

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles