mcp: add MCP server for AI-driven test execution

.github/workflows/static.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9"]
+        python-version: ["3.10"]
 
     steps:
     - name: Show OS
@@ -25,7 +25,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Install dependencies
-      run: python3 -m pip install ruff pyrefly msgpack asyncssh
+      run: python3 -m pip install ruff pyrefly msgpack asyncssh mcp
 
     - name: Test kirk
       run: ./kirk --help

.github/workflows/tests.yml

@@ -30,7 +30,7 @@ jobs:
       run: python3 -m build
 
     - name: Test with pytest
-      run: pytest -m "not qemu and not ssh and not ltx"
+      run: pytest -m "not qemu and not ssh and not ltx and not mcp"
 
   python3:
     runs-on: ubuntu-22.04
@@ -68,4 +68,36 @@ jobs:
       run: python3 -m build
 
     - name: Test with pytest
-      run: python3 -m pytest -m "not qemu and not ssh and not ltx"
+      run: python3 -m pytest -m "not qemu and not ssh and not ltx and not mcp"
+
+  python3-mcp:
+    runs-on: ubuntu-22.04
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [
+          "3.10",
+          "3.11",
+          "3.12",
+          "3.13",
+          "3.14"
+        ]
+
+    steps:
+    - name: Show OS
+      run: cat /etc/os-release
+
+    - name: Git checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: python3 -m pip install .[testing,mcp]
+
+    - name: Test with pytest
+      run: python3 -m pytest -m "mcp"

.gitignore

@@ -10,3 +10,4 @@ htmlcov
 .venv*
 *.qcow2
 .vscode
+.mcp.json

libkirk/main.py

@@ -434,6 +434,9 @@ def run(cmd_args: Optional[List[str]] = None) -> None:
     generic_opts.add_argument(
         "--plugins", "-P", type=str, help="Location of custom plugins"
     )
+    generic_opts.add_argument(
+        "--mcp", action="store_true", help="Start MCP server (stdio transport)"
+    )
 
     conf_opts = parser.add_argument_group("Configuration options")
     conf_opts.add_argument(
@@ -553,6 +556,12 @@ def run(cmd_args: Optional[List[str]] = None) -> None:
     if args.run_pattern and not args.run_suite:
         parser.error("--run-pattern must be used with --run-suite")
 
+    if args.mcp:
+        from libkirk.mcp_server import start_server
+
+        start_server()
+        return
+
     if not args.run_suite and not args.run_command:
         parser.error("--run-suite/--run-command are required")