remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for managing API credentials and environment configuration for the Huntress API server.
Used for installing dependencies and building the Huntress API MCP server.

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

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

Clonar el repositorio
Instalar dependencias:

npm install

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

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

View all tools

Servidor MCP para la integración de la API de Huntress

Huntress-MCP-Server