arch-ops-server 0.1.3__py3-none-any.whl → 3.0.0__py3-none-any.whl

arch_ops_server/system.py

@@ -0,0 +1,307 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
+"""
+System diagnostics and information module.
+Provides system health checks, disk space monitoring, and service status.
+"""
+
+import logging
+import os
+import re
+from pathlib import Path
+from typing import Dict, Any, List
+
+from .utils import (
+    IS_ARCH,
+    run_command,
+    create_error_response,
+    check_command_exists
+)
+
+logger = logging.getLogger(__name__)
+
+
+async def get_system_info() -> Dict[str, Any]:
+    """
+    Get core system information.
+
+    Returns:
+        Dict with kernel, architecture, hostname, uptime, memory info
+    """
+    logger.info("Gathering system information")
+
+    info = {}
+
+    try:
+        # Kernel version
+        exit_code, stdout, _ = await run_command(["uname", "-r"], timeout=5, check=False)
+        if exit_code == 0:
+            info["kernel"] = stdout.strip()
+
+        # Architecture
+        exit_code, stdout, _ = await run_command(["uname", "-m"], timeout=5, check=False)
+        if exit_code == 0:
+            info["architecture"] = stdout.strip()
+
+        # Hostname
+        exit_code, stdout, _ = await run_command(["hostname"], timeout=5, check=False)
+        if exit_code == 0:
+            info["hostname"] = stdout.strip()
+
+        # Uptime
+        exit_code, stdout, _ = await run_command(["uptime", "-p"], timeout=5, check=False)
+        if exit_code == 0:
+            info["uptime"] = stdout.strip()
+
+        # Memory info from /proc/meminfo
+        try:
+            meminfo_path = Path("/proc/meminfo")
+            if meminfo_path.exists():
+                with open(meminfo_path, "r") as f:
+                    meminfo = f.read()
+
+                # Parse memory values
+                mem_total_match = re.search(r"MemTotal:\s+(\d+)", meminfo)
+                mem_available_match = re.search(r"MemAvailable:\s+(\d+)", meminfo)
+
+                if mem_total_match:
+                    info["memory_total_kb"] = int(mem_total_match.group(1))
+                    info["memory_total_mb"] = int(mem_total_match.group(1)) // 1024
+
+                if mem_available_match:
+                    info["memory_available_kb"] = int(mem_available_match.group(1))
+                    info["memory_available_mb"] = int(mem_available_match.group(1)) // 1024
+        except Exception as e:
+            logger.warning(f"Failed to read memory info: {e}")
+
+        info["is_arch_linux"] = IS_ARCH
+
+        logger.info("Successfully gathered system information")
+        return info
+
+    except Exception as e:
+        logger.error(f"Failed to gather system info: {e}")
+        return create_error_response(
+            "SystemInfoError",
+            f"Failed to gather system information: {str(e)}"
+        )
+
+
+async def check_disk_space() -> Dict[str, Any]:
+    """
+    Check disk space for critical paths.
+
+    Returns:
+        Dict with disk usage for /, /home, /var, /var/cache/pacman/pkg
+    """
+    logger.info("Checking disk space")
+
+    paths_to_check = ["/", "/home", "/var"]
+
+    if IS_ARCH:
+        paths_to_check.append("/var/cache/pacman/pkg")
+
+    disk_info = {}
+
+    try:
+        for path in paths_to_check:
+            if not Path(path).exists():
+                continue
+
+            exit_code, stdout, _ = await run_command(
+                ["df", "-h", path],
+                timeout=5,
+                check=False
+            )
+
+            if exit_code == 0:
+                lines = stdout.strip().split('\n')
+                if len(lines) >= 2:
+                    # Parse df output
+                    parts = lines[1].split()
+                    if len(parts) >= 5:
+                        disk_info[path] = {
+                            "size": parts[1],
+                            "used": parts[2],
+                            "available": parts[3],
+                            "use_percent": parts[4],
+                            "mounted_on": parts[5] if len(parts) > 5 else path
+                        }
+
+                        # Check if space is critically low
+                        use_pct = int(parts[4].rstrip('%'))
+                        if use_pct > 90:
+                            disk_info[path]["warning"] = "Critical: Less than 10% free"
+                        elif use_pct > 80:
+                            disk_info[path]["warning"] = "Low: Less than 20% free"
+
+        logger.info(f"Checked disk space for {len(disk_info)} paths")
+
+        return {
+            "disk_usage": disk_info,
+            "paths_checked": len(disk_info)
+        }
+
+    except Exception as e:
+        logger.error(f"Failed to check disk space: {e}")
+        return create_error_response(
+            "DiskCheckError",
+            f"Failed to check disk space: {str(e)}"
+        )
+
+
+async def get_pacman_cache_stats() -> Dict[str, Any]:
+    """
+    Analyze pacman package cache.
+
+    Returns:
+        Dict with cache size, package count, statistics
+    """
+    if not IS_ARCH:
+        return create_error_response(
+            "NotSupported",
+            "Pacman cache analysis is only available on Arch Linux"
+        )
+
+    logger.info("Analyzing pacman cache")
+
+    cache_dir = Path("/var/cache/pacman/pkg")
+
+    try:
+        if not cache_dir.exists():
+            return create_error_response(
+                "NotFound",
+                "Pacman cache directory not found"
+            )
+
+        # Count packages
+        pkg_files = list(cache_dir.glob("*.pkg.tar.*"))
+        pkg_count = len(pkg_files)
+
+        # Calculate total size
+        total_size = sum(f.stat().st_size for f in pkg_files)
+        total_size_mb = total_size / (1024 * 1024)
+        total_size_gb = total_size_mb / 1024
+
+        logger.info(f"Cache: {pkg_count} packages, {total_size_gb:.2f} GB")
+
+        return {
+            "cache_dir": str(cache_dir),
+            "package_count": pkg_count,
+            "total_size_bytes": total_size,
+            "total_size_mb": round(total_size_mb, 2),
+            "total_size_gb": round(total_size_gb, 2)
+        }
+
+    except Exception as e:
+        logger.error(f"Failed to analyze cache: {e}")
+        return create_error_response(
+            "CacheAnalysisError",
+            f"Failed to analyze pacman cache: {str(e)}"
+        )
+
+
+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)}"
+        )
+
+
+async def get_boot_logs(lines: int = 100) -> Dict[str, Any]:
+    """
+    Retrieve recent boot logs.
+
+    Args:
+        lines: Number of lines to retrieve
+
+    Returns:
+        Dict with boot log contents
+    """
+    if not check_command_exists("journalctl"):
+        return create_error_response(
+            "NotSupported",
+            "journalctl not available (systemd-based system required)"
+        )
+
+    logger.info(f"Retrieving {lines} lines of boot logs")
+
+    try:
+        exit_code, stdout, stderr = await run_command(
+            ["journalctl", "-b", "-n", str(lines), "--no-pager"],
+            timeout=15,
+            check=False
+        )
+
+        if exit_code != 0:
+            return create_error_response(
+                "CommandError",
+                f"Failed to retrieve boot logs: {stderr}"
+            )
+
+        log_lines = stdout.strip().split('\n')
+
+        logger.info(f"Retrieved {len(log_lines)} lines of boot logs")
+
+        return {
+            "line_count": len(log_lines),
+            "logs": log_lines
+        }
+
+    except Exception as e:
+        logger.error(f"Failed to get boot logs: {e}")
+        return create_error_response(
+            "LogRetrievalError",
+            f"Failed to retrieve boot logs: {str(e)}"
+        )

arch_ops_server-3.0.0.dist-info/METADATA

@@ -0,0 +1,250 @@
+Metadata-Version: 2.3
+Name: arch-ops-server
+Version: 3.0.0
+Summary: MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)
+Keywords: arch-linux,mcp,model-context-protocol,aur,pacman,wiki,ai-assistant
+Author: Nihal
+Author-email: Nihal <2tv8xupqg@mozmail.com>
+License: GPL-3.0-only OR MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: Topic :: System :: Systems Administration
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: markdownify>=0.12.0
+Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0 ; extra == 'dev'
+Requires-Dist: httpx>=0.27.0 ; extra == 'dev'
+Requires-Python: >=3.11
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# Arch Linux MCP Server
+
+<a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" />
+</a>
+
+**Disclaimer:** Unofficial community project, not affiliated with Arch Linux.
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables intelligent, safe, and efficient access to the Arch Wiki, AUR, and official repositories for AI-assisted Arch Linux usage on Arch and non-Arch systems.
+
+Leverage AI to get  output for digestible, structured results that are ready for follow up questions and actions.
+
+📖 [Complete Documentation with Comfy Guides](https://nxk.mintlify.app/arch-mcp)
+
+## Sneak Peak into what's available
+
+<details open>
+<summary>Claude Desktop (no terminal)</summary>
+
+![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
+
+</details>
+
+<details>
+<summary>VS Code (with terminal)</summary>
+
+![VS Code Demo](assets/vscode_notesnook.gif)
+
+</details>
+
+### Resources (URI-based Access)
+
+Direct access to Arch ecosystem data via custom URI schemes:
+
+#### Documentation & Search
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
+
+#### Package Information
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archrepo://` | `archrepo://vim` | Official repository package details |
+| `aur://*/info` | `aur://yay/info` | AUR package metadata (votes, maintainer, dates) |
+| `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
+
+#### System Packages (Arch only)
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `pacman://installed` | `pacman://installed` | System installed packages list |
+| `pacman://orphans` | `pacman://orphans` | Orphaned packages |
+| `pacman://explicit` | `pacman://explicit` | Explicitly installed packages |
+| `pacman://groups` | `pacman://groups` | All package groups |
+| `pacman://group/*` | `pacman://group/base-devel` | Packages in specific group |
+| `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
+
+#### System Monitoring & Logs
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `system://info` | `system://info` | System information (kernel, memory, uptime) |
+| `system://disk` | `system://disk` | Disk space usage statistics |
+| `system://services/failed` | `system://services/failed` | Failed systemd services |
+| `system://logs/boot` | `system://logs/boot` | Recent boot logs |
+| `pacman://log/recent` | `pacman://log/recent` | Recent package transactions |
+| `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
+
+#### News & Updates
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
+| `archnews://critical` | `archnews://critical` | Critical news requiring manual intervention |
+| `archnews://since-update` | `archnews://since-update` | News since last system update |
+
+#### Configuration
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
+| `config://makepkg` | `config://makepkg` | Parsed makepkg.conf configuration |
+| `mirrors://active` | `mirrors://active` | Currently configured mirrors |
+| `mirrors://health` | `mirrors://health` | Mirror configuration health status |
+
+### Tools (Executable Functions)
+
+#### Package Search & Information
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `search_archwiki` | Query Arch Wiki with ranked results | Any |
+| `search_aur` | Search AUR (relevance/votes/popularity/modified) | Any |
+| `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
+
+#### Package Lifecycle Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `check_updates_dry_run` | Check for available updates | Arch only |
+| `install_package_secure` | Install with security checks (blocks malicious packages) | Arch only |
+| `remove_package` | Remove single package (with deps, forced) | Arch only |
+| `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
+
+#### Package Analysis & Maintenance
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_orphan_packages` | Find orphaned packages | Arch only |
+| `remove_orphans` | Clean orphans (dry-run, exclusions) | Arch only |
+| `verify_package_integrity` | Check file integrity (modified/missing files) | Arch only |
+| `list_explicit_packages` | List user-installed packages | Arch only |
+| `mark_as_explicit` | Prevent package from being orphaned | Arch only |
+| `mark_as_dependency` | Allow package to be orphaned | Arch only |
+
+#### Package Organization
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `find_package_owner` | Find which package owns a file | Arch only |
+| `list_package_files` | List files in package (regex filtering) | Arch only |
+| `search_package_files` | Search files across packages | Arch only |
+| `list_package_groups` | List all groups (base, base-devel, etc.) | Arch only |
+| `list_group_packages` | Show packages in specific group | Arch only |
+
+#### System Monitoring & Diagnostics
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_system_info` | System info (kernel, memory, uptime) | Any |
+| `check_disk_space` | Disk usage with warnings | Any |
+| `get_pacman_cache_stats` | Package cache size and age | Arch only |
+| `check_failed_services` | Find failed systemd services | systemd |
+| `get_boot_logs` | Retrieve journalctl boot logs | systemd |
+| `check_database_freshness` | Check package database sync status | Arch only |
+
+#### Transaction History & Logs
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
+| `find_when_installed` | Package installation history | Arch only |
+| `find_failed_transactions` | Failed package operations | Arch only |
+| `get_database_sync_history` | Database sync events | Arch only |
+
+#### News & Safety Checks
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_latest_news` | Fetch Arch Linux news from RSS | Any |
+| `check_critical_news` | Find critical news (manual intervention required) | Any |
+| `get_news_since_last_update` | News posted since last system update | Arch only |
+
+#### Mirror Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_active_mirrors` | Show configured mirrors | Arch only |
+| `test_mirror_speed` | Test mirror latency | Arch only |
+| `suggest_fastest_mirrors` | Recommend optimal mirrors by location | Any |
+| `check_mirrorlist_health` | Verify mirror configuration | Arch only |
+
+#### Configuration Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
+| `analyze_makepkg_conf` | Parse makepkg.conf settings | Arch only |
+| `check_ignored_packages` | List ignored packages (warns on critical) | Arch only |
+| `get_parallel_downloads_setting` | Get parallel download config | Arch only |
+
+#### Security Analysis
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
+| `analyze_package_metadata_risk` | Package trust scoring (votes, maintainer, age) | Any |
+
+### Prompts (Guided Workflows)
+
+| Prompt | Purpose | Workflow |
+|--------|---------|----------|
+| `troubleshoot_issue` | Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
+| `audit_aur_package` | Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
+| `analyze_dependencies` | Installation planning | Check repos → Map dependencies → Suggest install order |
+| `safe_system_update` | Safe update workflow | Check critical news → Verify disk space → List updates → Check services → Recommendations |
+
+---
+
+## Installation
+
+### Prerequisites
+- Python 3.11+
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Quick Install with `uvx`
+
+```bash
+uvx arch-ops-server
+```
+---
+
+## Configuration
+
+Claude / Cursor / Any MCP client that supports STDIO transport
+
+```json
+{
+  "mcpServers": {
+    "arch-ops": {
+      "command": "uvx",
+      "args": ["arch-ops-server"]
+    }
+  }
+}
+```
+
+## Contributing
+
+Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.
+
+[Contributing Guide](https://nxk.mintlify.app/arch-mcp/contributing)
+
+## License
+
+This project is dual-licensed under your choice of:
+
+- **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - See [LICENSE-GPL](LICENSE-GPL)
+- **[MIT License](https://opensource.org/licenses/MIT)** - See [LICENSE-MIT](LICENSE-MIT)
+
+You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.

arch_ops_server-3.0.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+arch_ops_server/__init__.py,sha256=TUG3zfhDW_dKXxAb9bXEz8CEi3HvJ4CI8JnykfxWbag,3971
+arch_ops_server/aur.py,sha256=poYbh2DW7I1tZfCeNp_7e10fh9ZZx8HTnYZnKKZtflQ,49808
+arch_ops_server/config.py,sha256=4mtpS28vXSMeEVGrTWTMwZEzgIyfl0oCAYEzF7SKxE8,11076
+arch_ops_server/logs.py,sha256=qWExDvluHmQvbZHu87veQxMnuMK8BNLBYBppZJlemEc,10558
+arch_ops_server/mirrors.py,sha256=Evt-g20cMOTZQl9FbbkbklFd0gKWz-I7vVNrmyQO19U,13403
+arch_ops_server/news.py,sha256=E97eASR24tq_EaVDYuamIoBl4a7QtBkpscOaUPuU0W4,9359
+arch_ops_server/pacman.py,sha256=S1Gc53CA6o4--YavA03EkxL0dGCZNhoFFZjawlW_p20,38354
+arch_ops_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+arch_ops_server/server.py,sha256=9t8KMZmy6MtQQXk7BwTz6oQNj3xwOGbINmDdxS2R-1M,72661
+arch_ops_server/system.py,sha256=JfBUB3KD0veulQ-IIK8IOC8Jn6lqtLMCtlnryiL1n7w,9221
+arch_ops_server/utils.py,sha256=po7MVqCx-hsdx-lOgs7uGicjoUVMf6HvuNNYl2qyFH0,10112
+arch_ops_server/wiki.py,sha256=XB_emMGXYF3Vn5likRICkGOa72YDZvOhtZBgp_d1gg8,7350
+arch_ops_server-3.0.0.dist-info/WHEEL,sha256=DpNsHFUm_gffZe1FgzmqwuqiuPC6Y-uBCzibcJcdupM,78
+arch_ops_server-3.0.0.dist-info/entry_points.txt,sha256=nD6HtiLT-Xh1b63_LGcYNEjHqVlal7I2d5jeFJMtfiU,63
+arch_ops_server-3.0.0.dist-info/METADATA,sha256=7cm5fc2uFbcCCxL26JRdU29VXGpVQv3p-WgsVo6hE_4,10581
+arch_ops_server-3.0.0.dist-info/RECORD,,