Tests: Add software tests for examples/mcptools.sh

Author: amotl

.github/workflows/tests.yml

@@ -68,6 +68,10 @@ jobs:
           enable-cache: true
           version: "latest"
 
+      - name: Set up mcptools
+        run: |
+          go install github.com/f/mcptools/cmd/mcptools@latest
+
       - name: Set up project
         run: |
           uv pip install --editable='.[all,develop,test]'

examples/mcptools.sh

@@ -1,4 +1,6 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
+
+set -euo pipefail
 
 # CrateDB MCP Server example with `mcptools`
 #
@@ -12,6 +14,9 @@
 # brew tap f/mcptools
 # brew install mcp uv
 
+# Some systems do not provide the `mcpt` alias.
+alias mcpt=mcptools
+
 # Explore the Text-to-SQL tools.
 mcpt call query_sql --params '{"query":"SELECT * FROM sys.summits LIMIT 3"}' uvx cratedb-mcp serve
 mcpt call get_table_metadata uvx cratedb-mcp serve
@@ -22,3 +27,5 @@ mcpt call get_cratedb_documentation_index uvx cratedb-mcp serve
 mcpt call \
   fetch_cratedb_docs --params '{"link":"https://cratedb.com/docs/cloud/en/latest/_sources/cluster/integrations/mongo-cdc.md.txt"}' \
   uvx cratedb-mcp serve
+
+echo "Ready."

tests/test_examples.py

@@ -0,0 +1,12 @@
+# ruff: noqa: S603, S607
+import subprocess
+from shutil import which
+
+import pytest
+
+
+@pytest.mark.skipif(not which("mcptools"), reason="requires mcptools")
+def test_mcptools():
+    proc = subprocess.run(["examples/mcptools.sh"], capture_output=True, timeout=15, check=True)
+    assert proc.returncode == 0
+    assert b"Ready." in proc.stdout