linux-mcp-server 1.3.0__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.0 → linux_mcp_server-1.3.2}/.github/workflows/ci.yml

@@ -49,7 +49,7 @@ jobs:
           python-version-file: pyproject.toml
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7.2.1
+        uses: astral-sh/setup-uv@v7.3.0
         with:
           enable-cache: true
           prune-cache: false
@@ -94,7 +94,7 @@ jobs:
           python-version-file: pyproject.toml
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7.2.1
+        uses: astral-sh/setup-uv@v7.3.0
         with:
           enable-cache: true
           prune-cache: false

{linux_mcp_server-1.3.0 → linux_mcp_server-1.3.2}/.github/workflows/ci_installation.yaml

@@ -52,7 +52,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7.2.1
+        uses: astral-sh/setup-uv@v7.3.0
         with:
           enable-cache: true
           prune-cache: false

{linux_mcp_server-1.3.0 → linux_mcp_server-1.3.2}/.github/workflows/docs.yml

@@ -34,7 +34,7 @@ jobs:
           python-version-file: pyproject.toml
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7.2.1
+        uses: astral-sh/setup-uv@v7.3.0
         with:
           enable-cache: true
           prune-cache: false

{linux_mcp_server-1.3.0 → 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.0 → linux_mcp_server-1.3.2}/.tekton/pipeline-build-multiarch.yaml

@@ -112,16 +112,6 @@ spec:
 
   tasks:
     - name: init
-      params:
-        - name: image-url
-          value: $(params.output-image)
-
-        - name: rebuild
-          value: $(params.rebuild)
-
-        - name: skip-checks
-          value: $(params.skip-checks)
-
       taskRef:
         resolver: bundles
         params:
@@ -129,7 +119,7 @@ spec:
             value: init
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-init:0.2@sha256:ebf06778aeacbbeb081f9231eafbdfdb8e380ad04e211d7ed80ae9101e37fd82
+            value: quay.io/konflux-ci/tekton-catalog/task-init:0.3@sha256:aa6f8632cc23d605c5942505ff1d00280db16a6fda5c4c56c4ed9ae936b5fbc6
 
           - name: kind
             value: task
@@ -169,12 +159,6 @@ spec:
           - name: kind
             value: task
 
-      when:
-        - input: $(tasks.init.results.build)
-          operator: in
-          values:
-            - "true"
-
       workspaces:
         - name: basic-auth
           workspace: git-auth
@@ -203,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
@@ -291,19 +275,13 @@ spec:
             value: buildah-remote-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-buildah-remote-oci-ta:0.8@sha256:da99fce12bf72da86f6a86a5370d826c16ea8db001d27181dcaf087af9ab60cb
+            value: quay.io/konflux-ci/tekton-catalog/task-buildah-remote-oci-ta:0.8@sha256:4c6e3e4c3fe8a289161dfbc38a162d28a0289eb4d51f835e847f8c3677a211f3
 
           - name: kind
             value: task
 
         resolver: bundles
 
-      when:
-        - input: $(tasks.init.results.build)
-          operator: in
-          values:
-            - "true"
-
     - name: build-image-index
       params:
         - name: IMAGE
@@ -335,17 +313,11 @@ spec:
             value: build-image-index
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-build-image-index:0.2@sha256:05d3d8a5ded44c51b074a56a408ddf5d65c56b4c15e110abb1a99e3aff269d49
+            value: quay.io/konflux-ci/tekton-catalog/task-build-image-index:0.2@sha256:30989fa1f475bb8f6bda811b26bd4ddf7187288ed5815ce634ba399341852c75
 
           - name: kind
             value: task
 
-      when:
-        - input: $(tasks.init.results.build)
-          operator: in
-          values:
-            - "true"
-
     - name: deprecated-base-image-check
       params:
         - name: IMAGE_URL
@@ -393,7 +365,7 @@ spec:
             value: clair-scan
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-clair-scan:0.3@sha256:dadfea7633d82e4303ba73d5e9c7e2bc16834bde0fd7688880453b26452067eb
+            value: quay.io/konflux-ci/tekton-catalog/task-clair-scan:0.3@sha256:b01d8e2c58eb407ac23fa07b8e44c4631f0cf7257e87507c829fa2486aff9804
 
           - name: kind
             value: task
@@ -418,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:0c3f9d4707bf742a5209f2e2186211433c83d5fcc538c728e4c7df178b5eafb7
+            value: quay.io/konflux-ci/tekton-catalog/task-ecosystem-cert-preflight-checks:0.2@sha256:40bc4bcc1c52c114139daee60ec2ddeb59921ecef8a68f241d5593c79b2a21d6
 
           - name: kind
             value: task
@@ -455,7 +427,7 @@ spec:
             value: sast-snyk-check-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-sast-snyk-check-oci-ta:0.4@sha256:a70272ae12f6d7f0da2902158e1bcee756877aa8f71fd1a22ef9afd8b177fb41
+            value: quay.io/konflux-ci/tekton-catalog/task-sast-snyk-check-oci-ta:0.4@sha256:0c2ab8ce6d419400b63dd67d061052ac51de7b1ebe93f8ae86ed07ac638d756d
 
           - name: kind
             value: task
@@ -484,7 +456,7 @@ spec:
             value: clamav-scan
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-clamav-scan:0.3@sha256:bcf08c20d35988bce353d36b915070a9ab7497e436e8c9d5db27ae9274e3c383
+            value: quay.io/konflux-ci/tekton-catalog/task-clamav-scan:0.3@sha256:5b5b31eae9063a00b91acc049b536e548d87c730068e439eefe33ab5238ee118
 
           - name: kind
             value: task
@@ -506,7 +478,7 @@ spec:
             value: coverity-availability-check
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-coverity-availability-check:0.2@sha256:267d5bc069a0323f41e24732ddfd1057e5c639e853d1e620c67505fab78f1301
+            value: quay.io/konflux-ci/tekton-catalog/task-coverity-availability-check:0.2@sha256:a24d8f3cd01ccc54fa6fb73aa57a78f5559a0e58eddfe0583fc9cb97d59b4efc
 
           - name: kind
             value: task
@@ -570,7 +542,7 @@ spec:
             value: sast-coverity-check-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-sast-coverity-check-oci-ta:0.3@sha256:9d0bc704bca6b6faad37b2ce8106b96e0cef35e1f647d037a878bf416589de9d
+            value: quay.io/konflux-ci/tekton-catalog/task-sast-coverity-check-oci-ta:0.3@sha256:e8c63570f1d01d70b2a21b22a2a4aad9ca7d5c0327d8b2a4058a6e616cce17ca
 
           - name: kind
             value: task
@@ -610,7 +582,7 @@ spec:
             value: sast-shell-check-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-sast-shell-check-oci-ta:0.1@sha256:e7a51575f9188a1461d4520da25aaa4efdd3b896c97dc750941fa22840e55c13
+            value: quay.io/konflux-ci/tekton-catalog/task-sast-shell-check-oci-ta:0.1@sha256:f475b4b6b0c1687fa1aafa5ba38813e04f080b185af2975e12b457742d9dd857
 
           - name: kind
             value: task
@@ -645,7 +617,7 @@ spec:
             value: sast-unicode-check-oci-ta
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-sast-unicode-check-oci-ta:0.4@sha256:1818a5b3e4fa86c838ae71226a157241967d1f19c5ed377e4b2fddad7a3ceefe
+            value: quay.io/konflux-ci/tekton-catalog/task-sast-unicode-check-oci-ta:0.4@sha256:b38140b2f0b2163def80e28a792b2702245d38a5610a504f2e56c198f3b8f70b
 
           - name: kind
             value: task
@@ -711,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:08bba4a659ecd48f871bef00b80af58954e5a09fcbb28a1783ddd640c4f6535e
+            value: quay.io/konflux-ci/tekton-catalog/task-push-dockerfile-oci-ta:0.1@sha256:2623be4a9bad87ade614b4b24a8f98a4e100042a845e8f162b8237168697294c
 
           - name: kind
             value: task
@@ -734,7 +706,7 @@ spec:
             value: rpms-signature-scan
 
           - name: bundle
-            value: quay.io/konflux-ci/tekton-catalog/task-rpms-signature-scan:0.2@sha256:2f3015ac7a642ea7f104d2194a8cb45921570f9539c6604ddcb5f62796f22a53
+            value: quay.io/konflux-ci/tekton-catalog/task-rpms-signature-scan:0.2@sha256:23f133f47d13e6fd35ad6a65138f5b48bd2e6c4e66a2512991ff9f7d90cd7e0e
 
           - name: kind
             value: task

{linux_mcp_server-1.3.0 → 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.0 → linux_mcp_server-1.3.2}/Containerfile

@@ -1,4 +1,4 @@
-FROM registry.access.redhat.com/ubi10-minimal:10.1-1769521234 as base
+FROM registry.access.redhat.com/ubi10-minimal:10.1-1770180557 as base
 
 FROM base as build
 

{linux_mcp_server-1.3.0 → 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.0 → linux_mcp_server-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linux-mcp-server
-Version: 1.3.0
+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.0 → 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.0 → 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.0 → linux_mcp_server-1.3.2}/scripts/publish_mcp_registry.py

@@ -95,7 +95,7 @@ def main():
     system, arch = get_platform_info()
     download_url = f"https://github.com/modelcontextprotocol/registry/releases/download/{mcp_publisher_version}/mcp-publisher_{system}_{arch}.tar.gz"
 
-    publisher_path = Path("./mcp-publisher")
+    publisher_path = Path("mcp-publisher").absolute()
     download_publisher(download_url, publisher_path)
 
     update_server_json(version)

{linux_mcp_server-1.3.0 → 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.0 → 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.0 → 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