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

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

Instalación local

De la fuente

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

2. Instalar dependencias:

3. Construir el servidor:

Configuración

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

Si se instala desde npm globalmente:

Si se instala desde npm localmente:

Si se instala desde la fuente:

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:

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)