linux-mcp-server 1.3.1__tar.gz → 1.3.2__tar.gz

linux_mcp_server-1.3.2/.github/workflows/build-publish.yml

@@ -0,0 +1,178 @@
+name: Build and publish
+on:
+  push:
+    tags:
+      - '*'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build sdist and wheel
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+        with:
+          fetch-depth: 0
+
+      - name: Show environment
+        run: |
+          set -x
+          python -VV
+          python -m site
+          ls -ld $(python -c "import site; print(site.getsitepackages()[0])")
+          git tag --list --sort=-refname --format='%(refname:short) %(objectname:short)'
+          whoami
+
+      - name: Install build tools
+        run: |
+         python -m pip install --upgrade pip
+         python -m pip install build
+
+      - name: Build
+        run: python -m build --sdist --wheel
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v6.0.0
+        with:
+          name: artifacts
+          path: dist
+          if-no-files-found: error
+
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs:
+      - build
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/linux-mcp-server
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v7.0.0
+        with:
+          name: artifacts
+          path: dist
+
+      - name: Show environment
+        run: |
+          set -x
+          python -VV
+          python -m site
+          ls -ld $(python -c "import site; print(site.getsitepackages()[0])")
+          ls -l dist/
+          whoami
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.13.0
+
+  publish-mcp:
+    name: Publish to MCP registry
+    runs-on: ubuntu-latest
+    needs:
+      - publish-pypi
+
+    environment:
+      name: mcp
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Publish to MCP Registry
+        run: ./scripts/publish_mcp_registry.py
+
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2.5.0
+        with:
+          tag_name: ${{ github.ref_name }}
+          generate_release_notes: true
+
+  zipapp:
+    name: Zipapp - ${{ matrix.python-version }} ${{ matrix.image.family }} ${{ matrix.image.arch }}
+    runs-on: ${{ matrix.image.name }}
+    needs:
+      - create-release
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+          - "3.14t"
+
+        image:
+          - name: ubuntu-24.04
+            family: linux
+            arch: amd64
+
+          - name: ubuntu-24.04-arm
+            family: linux
+            arch: arm64
+
+          - name: macos-15-intel
+            family: macos
+            arch: amd64
+
+          - name: macos-26
+            family: macos
+            arch: arm64
+
+          - name: windows-2025
+            family: windows
+            arch: amd64
+
+        exclude:
+          - python-version: "3.14t"
+            image:
+              name: windows-2025
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+        with:
+          ref: ${{ github.ref_name }}
+          fetch-depth: 0
+
+      - name: Install Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7.3.0
+
+      - name: Build zipapp
+        run: make zipapp ZIPAPP_OUTPUT=linux-mcp-server-py${{ matrix.python-version }}-${{ matrix.image.family }}-${{ matrix.image.arch }}.pyz
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v2.5.0
+        with:
+          files: linux-mcp-server-py${{ matrix.python-version }}-${{ matrix.image.family }}-${{ matrix.image.arch }}.pyz
+          tag_name: ${{ github.ref_name }}

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/.gitignore

@@ -19,6 +19,7 @@ wheels/
 *.egg-info/
 .installed.cfg
 *.egg
+*.pyz
 
 # Vendored packages
 src/linux_mcp_server/_vendor/*

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/.tekton/pipeline-build-multiarch.yaml

@@ -187,7 +187,7 @@ spec:
             value: prefetch-dependencies-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-prefetch-dependencies-oci-ta:0.2@sha256:c664a6df6514b59c3ce53570b0994b45af66ecc89ba2a8e41834eae0622addf6
+            value: quay.io/konflux-ci/tekton-catalog/task-prefetch-dependencies-oci-ta:0.2@sha256:c07551efbd7fc414ae1245ddd93579b00317fee0734980f539fd8aea3cfcb945
 
           - name: kind
             value: task
@@ -275,7 +275,7 @@ spec:
             value: buildah-remote-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-buildah-remote-oci-ta:0.8@sha256:f579f6d72db53da9e0b3f84e89d66d0f81c360a0785576308a93c3774b73be11
+            value: quay.io/konflux-ci/tekton-catalog/task-buildah-remote-oci-ta:0.8@sha256:4c6e3e4c3fe8a289161dfbc38a162d28a0289eb4d51f835e847f8c3677a211f3
 
           - name: kind
             value: task
@@ -313,7 +313,7 @@ spec:
             value: build-image-index
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-build-image-index:0.2@sha256:8fd2bd1329a833cf1c3c049c0044961d6f5d5bfc954ebf188c19a56852c42600
+            value: quay.io/konflux-ci/tekton-catalog/task-build-image-index:0.2@sha256:30989fa1f475bb8f6bda811b26bd4ddf7187288ed5815ce634ba399341852c75
 
           - name: kind
             value: task
@@ -390,7 +390,7 @@ spec:
             value: ecosystem-cert-preflight-checks
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-ecosystem-cert-preflight-checks:0.2@sha256:33b7133c0c132c361295c30947f73bd45a3a3b62a24b83f3d8cd7c71f757828c
+            value: quay.io/konflux-ci/tekton-catalog/task-ecosystem-cert-preflight-checks:0.2@sha256:40bc4bcc1c52c114139daee60ec2ddeb59921ecef8a68f241d5593c79b2a21d6
 
           - name: kind
             value: task
@@ -683,7 +683,7 @@ spec:
             value: push-dockerfile-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-push-dockerfile-oci-ta:0.1@sha256:6fb61bec5ef161225a850005233db68cfdc03ad54e1a54cc49cc98d98ea3d259
+            value: quay.io/konflux-ci/tekton-catalog/task-push-dockerfile-oci-ta:0.1@sha256:2623be4a9bad87ade614b4b24a8f98a4e100042a845e8f162b8237168697294c
 
           - name: kind
             value: task
@@ -706,7 +706,7 @@ spec:
             value: rpms-signature-scan
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-rpms-signature-scan:0.2@sha256:a99d8fd4c9027356b18e5d2910cc44dbc2fcb53c384ba34696645d9e7faa9084
+            value: quay.io/konflux-ci/tekton-catalog/task-rpms-signature-scan:0.2@sha256:23f133f47d13e6fd35ad6a65138f5b48bd2e6c4e66a2512991ff9f7d90cd7e0e
 
           - name: kind
             value: task

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/.tekton/push.yaml

@@ -41,7 +41,6 @@ spec:
     - name: additional-tags
       value:
         - latest
-        - '{{ target_branch }}'
 
   pipelineRef:
     name: pipeline-build-multiarch

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/Makefile

@@ -1,4 +1,4 @@
-.PHONY: help sync lint format types test ci verify fix clean docs docs-serve
+.PHONY: help sync lint format types test ci verify fix clean docs docs-serve zipapp
 
 # Default target
 help:
@@ -15,6 +15,9 @@ help:
 	@echo "  make fix      - Auto-fix lint and format issues"
 	@echo "  make clean    - Remove build artifacts and caches"
 	@echo ""
+	@echo "📦 Build Targets:"
+	@echo "  make zipapp   - Build a zipapp using shiv"
+	@echo ""
 	@echo "📚 Documentation Targets:"
 	@echo "  make docs       - Build documentation"
 	@echo "  make docs-serve - Serve docs locally with live reload"
@@ -47,8 +50,14 @@ fix:
 clean:
 	rm -rf .pytest_cache .ruff_cache .pyright coverage dist build site
 	rm -rf src/*.egg-info
+	rm -f *.pyz
 	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
 
+ZIPAPP_OUTPUT ?= linux-mcp-server.pyz
+
+zipapp:
+	uv run --locked shiv . -c linux-mcp-server -o $(ZIPAPP_OUTPUT) -p "/usr/bin/env python3"
+
 docs:
 	uv run --locked --group docs mkdocs build
 

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linux-mcp-server
-Version: 1.3.1
+Version: 1.3.2
 Summary: MCP server for read-only Linux system administration, diagnostics, and troubleshooting
 Project-URL: Source code, https://github.com/rhel-lightspeed/linux-mcp-server
 Project-URL: Bug Tracker, https://github.com/rhel-lightspeed/linux-mcp-server/issues

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/docs/install.md

@@ -253,6 +253,17 @@ sudo pacman -S python python-pip
 
 #### Installing Python
 
+Installing Python is not needed if you are using uv (recommended) -
+it will automatically install Python versions as needed.
+
+To check your installed version of Python:
+
+```bash
+python3 --version
+```
+
+linux-mcp-server requires Python 3.10 or newer.
+
 === "Official Python Installer (Recommended)"
 
     Download from [python.org/downloads/macos](https://www.python.org/downloads/macos/) and run the installer.
@@ -272,13 +283,7 @@ sudo pacman -S python python-pip
 
 #### Installing linux-mcp-server
 
-=== "pip"
-
-    ```bash
-    pip3 install --user linux-mcp-server
-    ```
-
-=== "uv"
+=== "uv (Recommended)"
 
     Install [uv](https://docs.astral.sh/uv/#installation).
 
@@ -288,6 +293,12 @@ sudo pacman -S python python-pip
     uv tool install linux-mcp-server
     ```
 
+=== "pip"
+
+    ```bash
+    pip3 install --user linux-mcp-server
+    ```
+
 ??? failure "Command not found after installation?"
 
     On macOS (which uses `zsh` by default), add the install location to your `PATH`:
@@ -302,6 +313,13 @@ sudo pacman -S python python-pip
     uv tool update-shell
     ```
 
+??? failure "No matching distribution found for linux-mcp-server"
+
+    If pip3 claims to be unable to find linux-mcp-server,
+    that probably means you have a too-old version
+    of Python. Check your python version
+    with `python3 --version` - it should be 3.10 or newer.
+
 #### SSH Setup on macOS
 
 macOS includes OpenSSH by default. To set up key-based authentication:

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/pyproject.toml

@@ -52,6 +52,7 @@ linux-mcp-server = "linux_mcp_server.__main__:cli"
 dev = [
     "ipdb",
     "ipython",
+    "shiv",
     {include-group = "lint"},
     {include-group = "test"},
 ]
@@ -142,6 +143,7 @@ tag-only = [
     "astral-sh/setup-uv",
     "codecov/codecov-action",
     "pypa/gh-action-pypi-publish",
+    "softprops/action-gh-release",
 ]
 
 [tool.pyright]

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/src/linux_mcp_server/connection/ssh.py

@@ -354,7 +354,6 @@ async def execute_command(
     Raises:
         ValueError: If host is provided without username
         ConnectionError: If remote connection fails
-        ToolError: If the command is missing
 
     Examples:
         # Local execution

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/src/linux_mcp_server/formatters.py

@@ -4,8 +4,6 @@ This module provides functions to format parsed data into
 human-readable strings for tool output.
 """
 
-from pathlib import Path
-
 from linux_mcp_server.models import ListeningPort
 from linux_mcp_server.models import NetworkConnection
 from linux_mcp_server.models import NetworkInterface
@@ -222,60 +220,6 @@ def format_service_logs(stdout: str, service_name: str, lines_count: int) -> str
     return "\n".join(lines)
 
 
-def format_journal_logs(
-    stdout: str,
-    lines_count: int,
-    unit: str | None = None,
-    priority: str | None = None,
-    since: str | None = None,
-    transport: str | None = None,
-) -> str:
-    """Format journal logs output.
-
-    Args:
-        stdout: Raw output from journalctl.
-        lines_count: Number of log lines.
-        unit: Optional unit filter.
-        priority: Optional priority filter.
-        since: Optional time filter.
-        transport: Optional transport filter (e.g., 'audit', 'kernel').
-
-    Returns:
-        Formatted string representation.
-    """
-    filters = []
-    if unit:
-        filters.append(f"unit={unit}")
-    if priority:
-        filters.append(f"priority={priority}")
-    if since:
-        filters.append(f"since={since}")
-
-    log_type = f"{transport.title()} Logs" if transport else "Journal Logs"
-    filter_str = f", {', '.join(filters)}" if filters else (", no filters" if not transport else "")
-    header = f"=== {log_type} (last {lines_count} entries{filter_str}) ===\n"
-
-    lines = [header]
-    lines.append(stdout)
-    return "\n".join(lines)
-
-
-def format_log_file(stdout: str, log_path: Path, lines_count: int) -> str:
-    """Format log file output.
-
-    Args:
-        stdout: Raw content from log file.
-        log_path: Path to the log file.
-        lines_count: Number of lines read.
-
-    Returns:
-        Formatted string representation.
-    """
-    lines = [f"=== Log File: {log_path} (last {lines_count} lines) ===\n"]
-    lines.append(stdout)
-    return "\n".join(lines)
-
-
 def format_disk_usage(stdout: str, disk_io: str | None = None) -> str:
     """Format disk usage output.
 

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/src/linux_mcp_server/models.py

@@ -1,9 +1,11 @@
 import typing as t
 
 from datetime import datetime
+from pathlib import Path
 
 from pydantic import BaseModel
 from pydantic import Field
+from pydantic import field_serializer
 from pydantic import model_validator
 
 from linux_mcp_server.utils.format import format_bytes
@@ -184,3 +186,15 @@ class NodeEntry(BaseModel):
 class StorageNodes(BaseModel):
     nodes: list[NodeEntry]
     total: int = Field(default_factory=field_length("nodes"))
+
+
+### Log models ###
+class LogEntries(BaseModel):
+    entries: list[str]
+    unit: str = ""
+    path: Path | None = None
+    lines_count: int = Field(default_factory=field_length("entries"))
+
+    @field_serializer("unit", "path")
+    def serialize_empty_as_null(self, value: str | Path | None) -> str | Path | None:
+        return value or None

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/src/linux_mcp_server/tools/logs.py

@@ -12,8 +12,7 @@ from pydantic.functional_validators import BeforeValidator
 from linux_mcp_server.audit import log_tool_call
 from linux_mcp_server.commands import get_command
 from linux_mcp_server.config import CONFIG
-from linux_mcp_server.formatters import format_journal_logs
-from linux_mcp_server.formatters import format_log_file
+from linux_mcp_server.models import LogEntries
 from linux_mcp_server.server import mcp
 from linux_mcp_server.utils import StrEnum
 from linux_mcp_server.utils.decorators import disallow_local_execution_in_containers
@@ -89,33 +88,33 @@ async def _get_journal_logs(
 @disallow_local_execution_in_containers
 async def get_journal_logs(
     unit: t.Annotated[
-        str | None,
+        str,
         Field(
             description="Filter by systemd unit name or pattern",
             examples=["sshd.service", "nginx", "httpd", "systemd-*", "audit*"],
         ),
-    ] = None,
+    ] = "",
     priority: t.Annotated[
-        str | None,
+        str,
         Field(
             description="Filter by syslog priority level (0-7), name, or range",
             examples=["err", "warning", "info", "debug", "3", "err..warning"],
         ),
-    ] = None,
+    ] = "",
     since: t.Annotated[
-        str | None,
+        str,
         Field(
             description="Filter entries since specified time (absolute or relative)",
             examples=["today", "yesterday", "-1h", "-30m", "-7d", "2025-01-15 10:00:00"],
         ),
-    ] = None,
+    ] = "",
     transport: t.Annotated[
         Transport | None,
         "Filter by journal transport (e.g., 'audit' for audit logs, 'kernel' for kernel messages, 'syslog' for syslog messages)",
     ] = None,
     lines: t.Annotated[int, Field(description="Number of log lines to retrieve. Default: 100", ge=1, le=10_000)] = 100,
     host: Host = None,
-) -> str:
+) -> LogEntries:
     """Get systemd journal logs.
 
     Retrieves entries from the systemd journal with optional filtering by unit,
@@ -128,12 +127,17 @@ async def get_journal_logs(
     )
 
     if returncode != 0:
-        return f"Error reading journal logs: {stderr}"
+        raise ToolError(f"Error reading journal logs: {stderr}")
 
     if is_empty_output(stdout):
-        return "No journal entries found matching the criteria."
+        raise ToolError("No journal entries found matching the criteria.")
 
-    return format_journal_logs(stdout, lines, unit, priority, since, transport)
+    entries = [line for line in stdout.strip().splitlines() if line]
+
+    return LogEntries(
+        entries=entries,
+        unit=unit,
+    )
 
 
 @mcp.tool(
@@ -155,7 +159,7 @@ async def read_log_file(
     ],
     lines: t.Annotated[int, Field(description="Number of lines to retrieve from the end.", ge=1, le=10_000)] = 100,
     host: Host = None,
-) -> str:
+) -> LogEntries:
     """Read a specific log file.
 
     Retrieves the last N lines from a log file. The file path must be in the
@@ -212,4 +216,6 @@ async def read_log_file(
     if is_empty_output(stdout):
         raise ToolError(f"Log file is empty: {log_path}")
 
-    return format_log_file(stdout, log_path, lines)
+    entries = [line for line in stdout.strip().splitlines() if line]
+
+    return LogEntries(entries=entries, path=log_path)

{linux_mcp_server-1.3.1 → linux_mcp_server-1.3.2}/tests/test_formatters.py

@@ -1,12 +1,8 @@
 """Tests for formatters module."""
 
-from pathlib import Path
-
 from linux_mcp_server.formatters import format_disk_usage
 from linux_mcp_server.formatters import format_hardware_info
-from linux_mcp_server.formatters import format_journal_logs
 from linux_mcp_server.formatters import format_listening_ports
-from linux_mcp_server.formatters import format_log_file
 from linux_mcp_server.formatters import format_network_connections
 from linux_mcp_server.formatters import format_network_interfaces
 from linux_mcp_server.formatters import format_process_detail
@@ -247,57 +243,6 @@ class TestFormatServiceLogs:
         assert "Accepted publickey" in result
 
 
-class TestFormatJournalLogs:
-    """Tests for format_journal_logs function."""
-
-    def test_format_no_filters(self):
-        """Test formatting without filters."""
-        stdout = "Dec 12 10:00:00 host kernel: Log message"
-        result = format_journal_logs(stdout, 100)
-        assert "=== Journal Logs (last 100 entries, no filters) ===" in result
-
-    def test_format_with_filters(self):
-        """Test formatting with filters."""
-        stdout = "Dec 12 10:00:00 host sshd[1234]: Message"
-        result = format_journal_logs(stdout, 50, unit="ssh.service", priority="err", since="today")
-        assert "unit=ssh.service" in result
-        assert "priority=err" in result
-        assert "since=today" in result
-
-    def test_format_with_transport_audit(self):
-        """Test formatting with transport=audit uses Audit Logs header."""
-        stdout = "Dec 12 10:00:00 host audit[1234]: SYSCALL"
-        result = format_journal_logs(stdout, 100, transport="audit")
-        assert "=== Audit Logs (last 100 entries" in result
-        assert "SYSCALL" in result
-
-    def test_format_with_transport_audit_and_other_filters(self):
-        """Test formatting with transport=audit combined with other filters includes all filters."""
-        stdout = "Dec 12 10:00:00 host audit[1234]: Error message"
-        result = format_journal_logs(stdout, 50, transport="audit", priority="err", since="today")
-        assert "=== Audit Logs (last 50 entries" in result
-        assert "priority=err" in result
-        assert "since=today" in result
-
-    def test_format_with_transport_kernel(self):
-        """Test formatting with transport=kernel uses Kernel Logs header."""
-        stdout = "Dec 12 10:00:00 host kernel: Kernel message"
-        result = format_journal_logs(stdout, 100, transport="kernel")
-        assert "=== Kernel Logs (last 100 entries)" in result
-        assert "Kernel message" in result
-
-
-class TestFormatLogFile:
-    """Tests for format_log_file function."""
-
-    def test_format_log_file(self):
-        """Test formatting log file."""
-        stdout = "2024-01-01 10:00:00 INFO Application started"
-        result = format_log_file(stdout, Path("/var/log/app.log"), 100)
-        assert "=== Log File: /var/log/app.log (last 100 lines) ===" in result
-        assert "Application started" in result
-
-
 class TestFormatDiskUsage:
     """Tests for format_disk_usage function."""