Servidor MCP systemd-coredump

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la funcionalidad systemd-coredump. Esto permite que las aplicaciones compatibles con MCP accedan, administren y analicen los volcados de memoria del sistema.

Características

• Enumere todos los volcados de núcleo disponibles en el sistema

• Obtenga información detallada sobre volcados de núcleo específicos

• Extraer archivos de volcado de núcleo a una ubicación específica

• Eliminar volcados de núcleo del sistema

Related MCP server: LLDB-MCP

Prerrequisitos

• Node.js 18+ y npm

• systemd-coredump debe estar instalado y configurado en el sistema

• La utilidad de línea de comandos coredumpctl debe estar disponible

Instalación

De npm (recomendado)

Instalación global

npm install -g @taskjp/server-systemd-coredump

Instalación local

npm install @taskjp/server-systemd-coredump

De la fuente

1. Clonar el repositorio o descargar el código fuente

2. Instalar dependencias:

cd systemd-coredump-server
npm install

3. Construir el servidor:

npm run build

Configuración

Agregue el servidor a su archivo de configuración de MCP:

Si se instala desde npm globalmente:

"systemd-coredump": {
  "command": "systemd-coredump-server",
  "args": [],
  "disabled": false,
  "autoApprove": []
}

Si se instala desde npm localmente:

"systemd-coredump": {
  "command": "node",
  "args": ["node_modules/@taskjp/server-systemd-coredump/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

Si se instala desde la fuente:

"systemd-coredump": {
  "command": "node",
  "args": ["/path/to/systemd-coredump-server/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

Uso

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. list_coredumps : enumera todos los volcados de núcleo disponibles en el sistema

   {
     "name": "list_coredumps"
   }

2. get_coredump_info : Obtenga información detallada sobre un volcado de núcleo específico

   {
     "name": "get_coredump_info",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }

3. extract_coredump : Extrae un volcado de núcleo a un archivo

   {
     "name": "extract_coredump",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345",
       "outputPath": "/path/to/output/core.dump"
     }
   }

4. remove_coredump : elimina un volcado de núcleo del sistema

   {
     "name": "remove_coredump",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }

5. get_coredump_config : obtiene la configuración actual del volcado de núcleo del sistema

   {
     "name": "get_coredump_config"
   }

   Esta herramienta devuelve información sobre la configuración actual del volcado de núcleo, incluyendo:

   • Si los volcados de memoria están habilitados

   • El patrón central actual

   • El límite del tamaño del núcleo

   • Si systemd está manejando los volcados de núcleo

6. set_coredump_enabled : Habilitar o deshabilitar la generación de volcado de núcleo

   {
     "name": "set_coredump_enabled",
     "arguments": {
       "enabled": true
     }
   }

   Si se configura como enabled " ( true , se habilitarán los volcados de memoria, mientras que false los deshabilitará. Nota: Esto cambia la configuración de ulimit para el shell actual. Para realizar cambios permanentes en todo el sistema, se requieren privilegios de root y la modificación de los archivos de configuración del sistema.

7. get_stacktrace : Obtener el seguimiento de la pila de un volcado de núcleo usando GDB

   {
     "name": "get_stacktrace",
     "arguments": {
       "id": "2023-04-20 12:34:56-12345"
     }
   }

   Esta herramienta utiliza GDB para extraer un seguimiento de pila formateado del volcado de núcleo. Nota: Requiere que el depurador de GDB esté instalado en el sistema.

Recursos disponibles

El servidor expone dos tipos de recursos:

1. Información del volcado de núcleo

   • Formato de URI: coredump:///<id>

   • Devuelve JSON con información detallada del volcado de núcleo

2. Rastreos de pila

   • Formato de URI: stacktrace:///<id>

   • Devuelve un seguimiento de pila formateado del volcado de núcleo

Donde <id> es el identificador único para un volcado de núcleo en el formato: <timestamp>-<pid> .

Por ejemplo:

coredump:///2023-04-20 12:34:56-12345
stacktrace:///2023-04-20 12:34:56-12345

Nota sobre los permisos

Algunas operaciones pueden requerir privilegios elevados, especialmente al extraer o eliminar volcados de memoria. Asegúrese de que el usuario que ejecuta el servidor MCP tenga los permisos adecuados para acceder a los volcados de memoria del sistema.

Licencia

Instituto Tecnológico de Massachusetts (MIT)