Servidor MCP de registros de SolarWinds

Un servidor de Protocolo de contexto de modelo (MCP) para acceder y visualizar los registros de SolarWinds Observability.

Nota -

Este servidor está incompleto actualmente, ya que no admite la búsqueda de datos estructurados (¿una limitación de la API REST?). No estoy seguro de si también necesita aceptar un centro de datos para usar en las llamadas a los puntos finales de la API. Abordaré ambos problemas cuando el tiempo lo permita (lo necesité para un problema real de trabajo; primero tengo que solucionarlo).

Herramientas

registros de búsqueda

Busque registros de SolarWinds Observability con filtrado opcional

Toma parámetros de búsqueda que incluyen filtro, rango de tiempo y opciones de paginación.
Devuelve entradas de registro formateadas con marcas de tiempo, nombres de host y mensajes.
Admite filtrado avanzado por grupo, entidad y más
El rango de búsqueda predeterminado son las últimas 24 horas

visualizar_registros

Generar una respuesta json de histograma para eventos de registro

Formateado para representaciones de Claude y Canvas
Intervalos de tiempo configurables (minuto, hora, día)
Admite zonas horarias UTC o locales
Filtros de consulta y rangos de tiempo personalizables
El rango de visualización predeterminado son las últimas 24 horas

Recursos

Búsqueda de registros de SolarWinds

Plantilla de URI: solarwinds://{query}/search
Devuelve entradas de registro que coinciden con la consulta especificada
Ejemplo: solarwinds://error/search

Instalación

Opcionalmente instalar desde npm:

npm install -g mcp-solarwinds

O clonar y compilar desde la fuente:

git clone https://github.com/@jakenuts/mcp-solarwinds.git
cd mcp-solarwinds
npm install
npm run build

O simplemente usa npx en tus configuraciones

Para la extensión Cline VSCode

Agregar a %APPDATA%/Code - Insiders/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json :

{
  "mcpServers": {
    "solarwinds": {
      "command": "npx",
      "args": ["-y", "mcp-solarwinds"],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      },
      "autoApprove": ["search_logs", "visualize_logs"]
    }
  }
}

Para Claude Desktop

Agregue al archivo de configuración apropiado:

Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "solarwinds": {
      "command": "npx",
      "args": ["-y", "mcp-solarwinds"],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Configuración especial de Windows

Si encuentra el problema de surgimiento de ENOENT npx en Windows, use esta configuración alternativa que especifica las rutas completas:

{
  "mcpServers": {
    "solarwinds": {
      "command": "C:\\Users\\[username]\\AppData\\Roaming\\nvm\\[node-version]\\node.exe",
      "args": [
        "C:\\Users\\[username]\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-solarwinds"
      ],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Configuración

El servidor MCP de SolarWinds Observability requiere un token de API para autenticarse con la API de SolarWinds Observability.

Métodos de configuración

Hay varias formas de proporcionar el token API:

Configuración de ajustes de MCP (recomendado) : Configure el token en su archivo de configuración de MCP
Variable de entorno : Establezca la variable de entorno SOLARWINDS_API_TOKEN
Archivo .env local (para pruebas) : cree un archivo .env en la raíz del proyecto con SOLARWINDS_API_TOKEN=your-token

Para realizar pruebas locales, puede:

Copia .env.example a .env y agrega tu token
Ejecute el script de ejemplo: node examples/local-test.js

Ejemplos de uso de herramientas

registros de búsqueda

Búsqueda básica:

{
  "filter": "error"
}

Búsqueda avanzada con rango de tiempo y paginación:

{
  "filter": "error",
  "entityId": "web-server",
  "startTime": "2025-03-01T00:00:00Z",
  "endTime": "2025-03-05T23:59:59Z",
  "pageSize": 100,
  "direction": "backward"
}

visualizar_registros

Histograma básico (gráfico ASCII):

{
  "filter": "error",
  "interval": "hour"
}

Visualización avanzada (gráfico ASCII):

{
  "filter": "error",
  "entityId": "web-server",
  "startTime": "2025-03-01T00:00:00Z",
  "endTime": "2025-03-05T23:59:59Z",
  "interval": "day",
  "use_utc": true
}

Visualización de Claude (formato JSON):

{
  "filter": "error",
  "interval": "hour",
  "format": "json"
}

El formato JSON devuelve datos que Claude puede visualizar como un gráfico:

{
  "timeRanges": ["12:02", "12:03", "12:04", "12:05", "12:06", "12:07", "12:08", "12:09"],
  "counts": [261, 47, 48, 48, 31, 262, 270, 33],
  "total": 1000,
  "queryParams": {
    "query": "error",
    "startTime": "2025-03-05T00:00:00.000Z",
    "endTime": "2025-03-05T23:59:59.000Z"
  }
}

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. El Inspector MCP ofrece útiles herramientas de depuración:

npm run debug:inspector

Esto le proporcionará una URL para acceder al inspector en su navegador, donde podrá:

Ver todos los mensajes de MCP
Inspeccionar las cargas útiles de solicitud/respuesta
Pruebe herramientas de forma interactiva
Supervisar el estado del servidor

Para pruebas locales sin el marco MCP:

# Create a .env file with your token
cp .env.example .env
# Edit .env to add your token
# Run the example script
node examples/local-test.js

Detalles técnicos

Desarrollado con TypeScript y el SDK de MCP
Utiliza axios para la comunicación API
Admite formatos de fecha ISO 8601 para rangos de tiempo
Genera histogramas ASCII para visualización de registros
Rango de búsqueda predeterminado: últimas 24 horas
Tamaño de página predeterminado: 50 registros
Admite múltiples métodos de autenticación

SolarWinds Logs MCP Server

Integrations

Servidor MCP de registros de SolarWinds

Nota -

Herramientas

registros de búsqueda

visualizar_registros

Recursos

Búsqueda de registros de SolarWinds

Instalación

Para la extensión Cline VSCode

Para Claude Desktop

Configuración especial de Windows

Configuración

Métodos de configuración

Ejemplos de uso de herramientas

registros de búsqueda

visualizar_registros

Desarrollo

Depuración

Detalles técnicos

Tools

Related Resources

Appeared in Searches