arch-mcp

Instructions

Implementation Reference

• src/arch_ops_server/system.py:203-259 (handler)

  The core handler function that implements the tool logic: checks if systemctl exists, runs 'systemctl --failed --no-pager', parses the output to extract failed services, and returns a structured dictionary with count, list of services, and all_ok flag.
  async def check_failed_services() -> Dict[str, Any]: """ Detect failed systemd services. Returns: Dict with list of failed services """ if not check_command_exists("systemctl"): return create_error_response( "NotSupported", "systemctl not available (systemd-based system required)" ) logger.info("Checking for failed services") try: exit_code, stdout, _ = await run_command( ["systemctl", "--failed", "--no-pager"], timeout=10, check=False ) # Parse output failed_services = [] lines = stdout.strip().split('\n') for line in lines: # Skip header and footer lines if line.startswith('●') or line.startswith('UNIT'): continue if 'loaded units listed' in line.lower(): continue # Parse service line parts = line.split() if parts and parts[0].endswith('.service'): failed_services.append({ "unit": parts[0], "load": parts[1] if len(parts) > 1 else "", "active": parts[2] if len(parts) > 2 else "", "sub": parts[3] if len(parts) > 3 else "", }) logger.info(f"Found {len(failed_services)} failed services") return { "failed_count": len(failed_services), "failed_services": failed_services, "all_ok": len(failed_services) == 0 } except Exception as e: logger.error(f"Failed to check services: {e}") return create_error_response( "ServiceCheckError", f"Failed to check failed services: {str(e)}" )
• src/arch_ops_server/server.py:924-930 (registration)

  MCP tool registration defining the tool name, description, and input schema (empty object since no parameters). This makes the tool discoverable via list_tools().
  name="check_failed_services", description="[MONITORING] Check for failed systemd services. Useful for diagnosing system issues. Works on systemd-based systems.", inputSchema={ "type": "object", "properties": {} } ),
• src/arch_ops_server/server.py:1348-1351 (registration)

  Tool dispatch handler in call_tool() that invokes the check_failed_services function and returns the result as formatted JSON text content.
  elif name == "check_failed_services": result = await check_failed_services() return [TextContent(type="text", text=json.dumps(result, indent=2))]
• src/arch_ops_server/server.py:927-930 (schema)

  Input schema definition: empty properties object indicating the tool takes no parameters.
  "type": "object", "properties": {} } ),
• src/arch_ops_server/tool_metadata.py:322-329 (helper)

  Tool metadata providing categorization, platform requirements, permissions, workflow context, and related tools for better tool discovery and usage guidance.
  "check_failed_services": ToolMetadata( name="check_failed_services", category="monitoring", platform="systemd", permission="read", workflow="diagnose", related_tools=["get_boot_logs", "get_system_info"], prerequisite_tools=[]