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
npm install -g @taskjp/server-systemd-coredump
Instalación local
npm install @taskjp/server-systemd-coredump
De la fuente
- Clonar el repositorio o descargar el código fuente
- Instalar dependencias:
cd systemd-coredump-server
npm install
- Construir el servidor:
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:
- list_coredumps : enumera todos los volcados de núcleo disponibles en el sistema
{
"name": "list_coredumps"
}
- 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"
}
}
- 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"
}
}
- remove_coredump : elimina un volcado de núcleo del sistema
{
"name": "remove_coredump",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
- get_coredump_config : obtiene la configuración actual del volcado de núcleo del sistema
{
"name": "get_coredump_config"
}
- 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
- set_coredump_enabled : Habilitar o deshabilitar la generación de volcado de núcleo
{
"name": "set_coredump_enabled",
"arguments": {
"enabled": true
}
}
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. - 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"
}
}
Recursos disponibles
El servidor expone dos tipos de recursos:
- Información del volcado de núcleo
- Formato de URI:
coredump:///<id> - Devuelve JSON con información detallada del volcado de núcleo
- 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)