get_services_status
Check systemd, Docker, and PM2 service status on a remote server to monitor operational health and identify issues.
Instructions
Récupère le statut de tous les services connus (systemd, Docker, PM2) sur un serveur.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alias | Yes | Alias du serveur cible. |
Implementation Reference
- server.js:275-300 (handler)Executes the tool by running SSH commands to fetch status of systemd services, Docker containers, and PM2 processes on the specified server alias, parses the output, and returns structured JSON or error.async (params) => { try { const cmd = "systemctl --type=service --state=running --no-pager ; echo '---DOCKER---' ; docker ps --format '{{.Names}}: {{.Status}}' ; echo '---PM2---' ; pm2 list"; const job = queue.addJob({ type: 'ssh', alias: params.alias, cmd: cmd }); ssh.executeCommand(job.id); const result = await waitForJobCompletion(job.id, config.syncTimeout); if (!result || result.status !== 'completed') { throw new Error(result ? result.error : `Timeout de la commande de monitoring pour ${params.alias}`); } const parsedOutput = ssh.parseServicesStatus(result.output); return { content: [{ type: "text", text: JSON.stringify(parsedOutput, null, 2) }] }; } catch (e) { const errorPayload = { toolName: "get_services_status", errorCode: "MONITORING_ERROR", errorMessage: e.message }; return { content: [{ type: "text", text: JSON.stringify(errorPayload, null, 2) }], isError: true }; } }
- server.js:271-273 (schema)Zod input schema requiring a server alias.inputSchema: z.object({ alias: z.string().describe("Alias du serveur cible.") })
- server.js:266-301 (registration)Registers the 'get_services_status' tool with MCP server, including title, description, input schema, and handler function.server.registerTool( "get_services_status", { title: "Obtenir le statut des services d'un VPS", description: "Récupère le statut de tous les services connus (systemd, Docker, PM2) sur un serveur.", inputSchema: z.object({ alias: z.string().describe("Alias du serveur cible.") }) }, async (params) => { try { const cmd = "systemctl --type=service --state=running --no-pager ; echo '---DOCKER---' ; docker ps --format '{{.Names}}: {{.Status}}' ; echo '---PM2---' ; pm2 list"; const job = queue.addJob({ type: 'ssh', alias: params.alias, cmd: cmd }); ssh.executeCommand(job.id); const result = await waitForJobCompletion(job.id, config.syncTimeout); if (!result || result.status !== 'completed') { throw new Error(result ? result.error : `Timeout de la commande de monitoring pour ${params.alias}`); } const parsedOutput = ssh.parseServicesStatus(result.output); return { content: [{ type: "text", text: JSON.stringify(parsedOutput, null, 2) }] }; } catch (e) { const errorPayload = { toolName: "get_services_status", errorCode: "MONITORING_ERROR", errorMessage: e.message }; return { content: [{ type: "text", text: JSON.stringify(errorPayload, null, 2) }], isError: true }; } } );
- ssh.js:413-467 (helper)Helper function in ssh.js that parses the combined output from systemctl, docker ps, and pm2 list commands into a structured object with systemd, docker, and pm2 services lists.function parseServicesStatus(output) { const services = { systemd: [], docker: [], pm2: [] }; try { const sections = output.split(/---DOCKER---|---PM2---/); const systemdRaw = sections[0] || ''; const dockerRaw = sections[1] || ''; const pm2Raw = sections[2] || ''; // Parse systemd if (systemdRaw) { const lines = systemdRaw.trim().split('\n'); lines.forEach(line => { const match = line.match(/^(\S+)\s+loaded\s+active\s+running/); if (match && match[1]) { services.systemd.push({ name: match[1], status: 'running' }); } }); } // Parse Docker if (dockerRaw) { const lines = dockerRaw.trim().split('\n').filter(Boolean); lines.forEach(line => { const parts = line.split(': '); if (parts.length >= 2) { services.docker.push({ name: parts[0].trim(), status: parts.slice(1).join(': ').trim() }); } }); } // Parse PM2 if (pm2Raw) { const lines = pm2Raw.trim().split('\n'); const tableStartIndex = lines.findIndex(line => line.includes('│ id │')); if (tableStartIndex !== -1) { const tableBody = lines.slice(tableStartIndex + 2, -1); // Skip header, separator, and footer tableBody.forEach(line => { const columns = line.split('│').map(s => s.trim()).filter(Boolean); if (columns.length >= 4) { // id, name, namespace, status services.pm2.push({ id: columns[0], name: columns[1], status: columns[3] }); } }); } } } catch (e) { return { raw_output: output, parsing_error: e.message }; } return services; }