stackql-mcp-server 0.10.500__py3-none-any.whl

stackql_mcp_server/__init__.py

@@ -0,0 +1,128 @@
+"""
+stackql-mcp-server - uvx/pip-able launcher for the StackQL MCP server.
+
+On first run, downloads the platform's signed .mcpb bundle from the GitHub
+release pinned in platforms.json, verifies its sha256, extracts the stackql
+binary into ~/.stackql/mcp-server-bin/<version>/ (a cache shared with the
+@stackql/mcp-server npm wrapper), then runs it as an MCP stdio server.
+
+Extra arguments are passed through to stackql after the standard MCP args:
+
+  uvx stackql-mcp-server --auth='{"github":{"type":"null_auth"}}'
+
+Env overrides:
+  STACKQL_MCP_BIN     path to an existing stackql binary (skips download)
+  STACKQL_MCP_BUNDLE  path to a local .mcpb to extract from (CI/testing;
+                      skips download and sha verification)
+
+All diagnostics go to stderr - stdout belongs to the MCP protocol.
+Stdlib only, no dependencies.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import platform as _platform
+import subprocess
+import sys
+import urllib.request
+import zipfile
+from importlib.resources import files
+from io import BytesIO
+from pathlib import Path
+
+
+def _log(msg: str) -> None:
+    print(f"stackql-mcp: {msg}", file=sys.stderr, flush=True)
+
+
+def _platform_key() -> str | None:
+    machine = _platform.machine().lower()
+    if sys.platform.startswith("linux"):
+        if machine in ("x86_64", "amd64"):
+            return "linux-x64"
+        if machine in ("arm64", "aarch64"):
+            return "linux-arm64"
+        return None
+    if sys.platform == "win32":
+        return "windows-x64" if machine in ("x86_64", "amd64") else None
+    if sys.platform == "darwin":
+        return "darwin-universal"  # universal binary covers x64 + arm64
+    return None
+
+
+def _load_manifest() -> dict:
+    return json.loads(files(__package__).joinpath("platforms.json").read_text())
+
+
+def _download(url: str) -> bytes:
+    req = urllib.request.Request(url, headers={"User-Agent": "stackql-mcp-server"})
+    with urllib.request.urlopen(req) as resp:  # follows redirects
+        return resp.read()
+
+
+def _extract_binary(bundle: bytes, entry_name: str, dest: Path) -> None:
+    with zipfile.ZipFile(BytesIO(bundle)) as zf:
+        data = zf.read(entry_name)
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    # write-then-rename so a concurrent first run cannot see a half-written binary
+    tmp = dest.with_name(f"{dest.name}.tmp-{os.getpid()}")
+    tmp.write_bytes(data)
+    tmp.chmod(0o755)
+    tmp.replace(dest)
+
+
+def _ensure_binary() -> str:
+    override = os.environ.get("STACKQL_MCP_BIN")
+    if override:
+        return override
+
+    key = _platform_key()
+    if key is None:
+        _log(f"unsupported platform: {sys.platform}/{_platform.machine()}")
+        raise SystemExit(1)
+
+    manifest = _load_manifest()
+    info = manifest["platforms"][key]
+    bin_name = "stackql.exe" if key == "windows-x64" else "stackql"
+    bin_path = (
+        Path.home() / ".stackql" / "mcp-server-bin" / manifest["version"] / key / bin_name
+    )
+    if bin_path.exists():
+        return str(bin_path)
+
+    local_bundle = os.environ.get("STACKQL_MCP_BUNDLE")
+    if local_bundle:
+        bundle = Path(local_bundle).read_bytes()
+    else:
+        url = f"{manifest['baseUrl']}/{info['bundle']}"
+        _log(f"downloading {info['bundle']} (first run only) ...")
+        bundle = _download(url)
+        digest = hashlib.sha256(bundle).hexdigest()
+        if digest != info["sha256"]:
+            _log(f"sha256 mismatch for {info['bundle']}")
+            _log(f"  expected {info['sha256']}")
+            _log(f"  got      {digest}")
+            raise SystemExit(1)
+    _extract_binary(bundle, f"server/{bin_name}", bin_path)
+    _log(f"installed {bin_path}")
+    return str(bin_path)
+
+
+def main() -> None:
+    bin_path = _ensure_binary()
+    # approot and the audit sink must not depend on the cwd: MCP clients may
+    # launch this with cwd '/' (read-only on macOS). Later duplicate flags
+    # win, so user-passed overrides still take effect.
+    args = [
+        bin_path,
+        "mcp",
+        "--mcp.server.type=stdio",
+        "--approot", str(Path.home() / ".stackql"),
+        "--mcp.config", json.dumps({"server": {"audit": {"disabled": True}}}),
+        *sys.argv[1:],
+    ]
+    if os.name != "nt":
+        os.execv(bin_path, args)  # replace this process; signals flow naturally
+    raise SystemExit(subprocess.call(args))

stackql_mcp_server/platforms.json

@@ -0,0 +1,10 @@
+{
+  "version": "0.10.500",
+  "baseUrl": "https://github.com/stackql/stackql/releases/download/v0.10.500",
+  "platforms": {
+    "linux-x64": { "bundle": "stackql-mcp-linux-x64.mcpb", "sha256": "6615737747156b1a8413a976afb23af2e7eec29ebc98a6f0a0f65d1b153c44be" },
+    "linux-arm64": { "bundle": "stackql-mcp-linux-arm64.mcpb", "sha256": "594bedbabc3096dc3563c907724e845ce0b61a67de4b3fed4158b40c0363786c" },
+    "windows-x64": { "bundle": "stackql-mcp-windows-x64.mcpb", "sha256": "d2ce895e88f9c6b557df07073158629808f56d75598f3a701164d65506b791b0" },
+    "darwin-universal": { "bundle": "stackql-mcp-darwin-universal.mcpb", "sha256": "4eed70af5cfa67295ae0b42fa3a6dca71ac9acabd0d67914fd96ad1247a9b4cc" }
+  }
+}

stackql_mcp_server-0.10.500.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: stackql-mcp-server
+Version: 0.10.500
+Summary: StackQL MCP server - SQL-native query and provisioning engine for cloud infrastructure, served over MCP. Downloads the signed stackql binary on first run.
+Project-URL: Homepage, https://stackql.io
+Project-URL: Documentation, https://stackql.io/docs
+Project-URL: Source, https://github.com/stackql/stackql
+Author-email: StackQL Studios <info@stackql.io>
+License-Expression: MIT
+Keywords: cloud,devops,infrastructure,mcp,model-context-protocol,multicloud,sql,stackql
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# stackql-mcp-server
+
+mcp-name: io.github.stackql/stackql-mcp
+
+uvx/pip-able launcher for the [StackQL](https://stackql.io) MCP server - a
+SQL-native query and provisioning engine for cloud and SaaS infrastructure
+(AWS, Azure, Google, GitHub, Databricks, and 40+ other providers), served over
+the Model Context Protocol.
+
+On first run, the launcher downloads the signed `stackql` binary for your
+platform from the matching GitHub release (sha256-verified against pins baked
+into this package), caches it under `~/.stackql/mcp-server-bin/`, and starts
+it as an MCP stdio server. Subsequent runs start instantly from the cache.
+Pure stdlib - no dependencies.
+
+## Usage
+
+With any MCP client that supports stdio servers:
+
+```json
+{
+  "mcpServers": {
+    "stackql": {
+      "command": "uvx",
+      "args": ["stackql-mcp-server"]
+    }
+  }
+}
+```
+
+Provider credentials are passed through with stackql's standard `--auth` flag:
+
+```json
+{
+  "mcpServers": {
+    "stackql": {
+      "command": "uvx",
+      "args": [
+        "stackql-mcp-server",
+        "--auth={\"github\":{\"type\":\"null_auth\"}}"
+      ]
+    }
+  }
+}
+```
+
+Or install it: `pip install stackql-mcp-server`, then use `stackql-mcp` as the
+command. Any extra arguments are passed to `stackql` after the standard MCP
+server arguments. The launcher sets `--approot` to `~/.stackql` and disables
+the audit file sink by default; pass your own `--approot` or `--mcp.config`
+to override (later flags win).
+
+## Environment overrides
+
+- `STACKQL_MCP_BIN` - path to an existing `stackql` binary; skips the download.
+- `STACKQL_MCP_BUNDLE` - path to a local `.mcpb` bundle to extract the binary
+  from (testing; skips download and sha verification).
+
+## Other installation vectors
+
+- Claude Desktop one-click bundles (`.mcpb`):
+  https://github.com/stackql/stackql/releases/latest
+- npm: `npx -y @stackql/mcp-server`
+- Docker: `docker run -i --rm stackql/stackql-mcp`
+- Native installers and package managers: https://stackql.io/docs/installing-stackql
+
+## Links
+
+- Docs: https://stackql.io/docs
+- MCP Registry: `io.github.stackql/stackql-mcp`
+- Source: https://github.com/stackql/stackql

stackql_mcp_server-0.10.500.dist-info/RECORD

@@ -0,0 +1,6 @@
+stackql_mcp_server/__init__.py,sha256=mKwdLeQdsoM1vRZmX2sgn3BDvKpbawZCIr0xj-seKiw,4362
+stackql_mcp_server/platforms.json,sha256=HwwZqLRXEBExQztMTZY93ruSmY_nsqPlpwkUtgikLCw,706
+stackql_mcp_server-0.10.500.dist-info/METADATA,sha256=TwJbOUdI2eUyHDu-OmpkI3nE-_pYA011VF3q36TNnl0,2959
+stackql_mcp_server-0.10.500.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+stackql_mcp_server-0.10.500.dist-info/entry_points.txt,sha256=31my4mwZ6PY1MtGAhpH4pgkXlyIr3wE0Nk3FLB22DZo,101
+stackql_mcp_server-0.10.500.dist-info/RECORD,,

stackql_mcp_server-0.10.500.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

stackql_mcp_server-0.10.500.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+stackql-mcp = stackql_mcp_server:main
+stackql-mcp-server = stackql_mcp_server:main