aisec-suite 0.2.0__py3-none-any.whl

aisec/__init__.py

@@ -0,0 +1,2 @@
+"""aisec-suite: unified runner and SARIF exporter for mcpaudit, memsentry and ragsentry."""
+__version__ = "0.2.0"

aisec/adapters.py

@@ -0,0 +1,108 @@
+"""Adapters that run each scanner and normalise its findings. Scanners are imported lazily; a missing
+scanner is reported and skipped rather than crashing the run."""
+from __future__ import annotations
+
+import json
+import os
+import pathlib
+
+from aisec.extract import extract_tools
+from aisec.model import Finding
+
+CONTEXT_NAMES = {"CLAUDE.md", "AGENTS.md", "GEMINI.md", ".cursorrules", ".windsurfrules", ".clinerules", "copilot-instructions.md"}
+_SKIP = {"node_modules", ".git", "venv", ".venv"}
+_CHUNK = 50  # large manifests scale super-linearly in mcpaudit's cross-tool check
+
+
+def _rel(p: pathlib.Path, root: pathlib.Path) -> str:
+    try:
+        return str(p.relative_to(root))
+    except ValueError:
+        return str(p)
+
+
+def _walk(root: pathlib.Path):
+    """Yield regular files under root, pruning vendored dirs *before* descending and never following symlinks
+    (a repo under scan is untrusted input: a symlink must not make us read files outside it)."""
+    for dirpath, dirs, files in os.walk(root, followlinks=False):
+        dirs[:] = [d for d in dirs if d not in _SKIP]
+        for name in files:
+            p = pathlib.Path(dirpath, name)
+            if not p.is_symlink():
+                yield p
+
+
+def scan_mcp_source(root: pathlib.Path, include_tests: bool = False, warnings: list[str] | None = None) -> tuple[list[Finding], int]:
+    """Statically extract tools from source, run mcpaudit's static checks. Returns (findings, tools_found)."""
+    try:
+        from mcpaudit.checks.description_scan import scan_descriptions
+        from mcpaudit.checks.permission_scope import check_scope
+        from mcpaudit.manifest import ServerManifest, ToolManifest
+    except ImportError:
+        if warnings is not None:
+            warnings.append("mcpaudit not installed: skipped MCP tool checks")
+        return [], 0
+    tools = extract_tools(root, include_tests)
+    findings: list[Finding] = []
+    for i in range(0, len(tools), _CHUNK):
+        part = tools[i:i + _CHUNK]
+        manifest = ServerManifest(server_name=root.name, tools=[ToolManifest(t["name"], t["description"], t["input_schema"]) for t in part])
+        by_name = {t["name"]: t for t in part}
+        for f in scan_descriptions(manifest) + check_scope(manifest):
+            src = by_name.get(f.tool, {})
+            findings.append(Finding("mcpaudit", f"{f.check}: {f.title}", f.severity.value, f.detail, src.get("file", "."), src.get("line", 1)))
+    return findings, len(tools)
+
+
+def scan_manifest_files(root: pathlib.Path, warnings: list[str] | None = None) -> list[Finding]:
+    """Scan *.json files shaped like {"server_name":..., "tools":[...]} (e.g. an mcpaudit baseline)."""
+    try:
+        from mcpaudit.checks.description_scan import scan_descriptions
+        from mcpaudit.checks.permission_scope import check_scope
+        from mcpaudit.manifest import ServerManifest
+    except ImportError:
+        return []
+    out: list[Finding] = []
+    for p in _walk(root):
+        if p.suffix != ".json" or p.stat().st_size > 5_000_000:
+            continue
+        try:
+            d = json.loads(p.read_text(encoding="utf-8", errors="replace"))
+            if not (isinstance(d, dict) and "server_name" in d and isinstance(d.get("tools"), list)):
+                continue
+            m = ServerManifest.from_dict(d)
+        except Exception:
+            continue
+        for f in scan_descriptions(m) + check_scope(m):
+            out.append(Finding("mcpaudit", f"{f.check}: {f.title}", f.severity.value, f.detail, _rel(p, root), 1))
+    return out
+
+
+def scan_context_files(root: pathlib.Path, warnings: list[str] | None = None) -> list[Finding]:
+    try:
+        from memsentry.memfile import MemoryFile
+        from memsentry.scanner import scan_file
+    except ImportError:
+        if warnings is not None:
+            warnings.append("memsentry not installed: skipped agent-context file checks")
+        return []
+    out: list[Finding] = []
+    for p in _walk(root):
+        if p.name in CONTEXT_NAMES or (p.parent.name == "rules" and p.parent.parent.name == ".cursor"):
+            for f in scan_file(MemoryFile.load(p)):
+                out.append(Finding("memsentry", f"{f.check}: {f.title}", f.severity.value, f.detail, _rel(p, root), f.line))
+    return out
+
+
+def scan_rag_dir(rag_dir: pathlib.Path, root: pathlib.Path, warnings: list[str] | None = None) -> list[Finding]:
+    try:
+        from ragsentry.scanner import scan_path
+    except ImportError:
+        if warnings is not None:
+            warnings.append("ragsentry not installed: skipped RAG document checks")
+        return []
+    out: list[Finding] = []
+    for fname, fs in scan_path(str(rag_dir)).items():
+        for f in fs:
+            out.append(Finding("ragsentry", f"{f.check}: {f.title}", f.severity.value, f.detail, _rel(pathlib.Path(fname), root), f.line))
+    return out

aisec/cli.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+import collections
+import json
+import os
+import pathlib
+from typing import Optional
+
+import typer
+
+from aisec import __version__
+from aisec.adapters import scan_context_files, scan_manifest_files, scan_mcp_source, scan_rag_dir
+from aisec.model import SEVERITY_ORDER, at_least
+from aisec.sarif import to_sarif
+from aisec.summary import to_markdown
+
+app = typer.Typer(name="aisec", help="Run mcpaudit, memsentry and ragsentry on a repository in one command.", no_args_is_help=True)
+
+
+@app.callback()
+def _main(version: bool = typer.Option(False, "--version", is_eager=True)) -> None:
+    if version:
+        typer.echo(__version__)
+        raise typer.Exit()
+
+
+@app.command()
+def scan(
+    path: pathlib.Path = typer.Argument(..., exists=True, file_okay=False, help="Repository root to scan."),
+    rag: Optional[pathlib.Path] = typer.Option(None, "--rag", help="Directory of RAG source documents to scan with ragsentry."),
+    sarif: Optional[pathlib.Path] = typer.Option(None, "--sarif", help="Write SARIF 2.1.0 here (for GitHub code scanning)."),
+    json_out: Optional[pathlib.Path] = typer.Option(None, "--json", help="Write findings as JSON here."),
+    fail_on: Optional[str] = typer.Option(None, "--fail-on", help="Exit 1 if any finding is at or above: low|medium|high|critical."),
+    include_tests: bool = typer.Option(False, "--include-tests", help="Also extract tools from tests/examples/fixtures."),
+    baseline: Optional[pathlib.Path] = typer.Option(None, "--baseline", help="JSON file of accepted findings; they are hidden and never fail the run."),
+    write_baseline: Optional[pathlib.Path] = typer.Option(None, "--write-baseline", help="Write current findings as a baseline (accept everything seen today)."),
+    summary: Optional[pathlib.Path] = typer.Option(None, "--summary", help="Write a Markdown summary here (defaults to $GITHUB_STEP_SUMMARY when set)."),
+) -> None:
+    if fail_on and fail_on not in SEVERITY_ORDER:
+        raise typer.BadParameter("must be one of low|medium|high|critical")
+    root = path.resolve()
+    warnings: list[str] = []
+    crashed: list[str] = []
+
+    def guarded(label, fn, default, *args):
+        """A scanner bug must not masquerade as 'findings exist' (exit 1) nor as a clean pass."""
+        try:
+            return fn(*args)
+        except Exception as e:  # noqa: BLE001 - third-party scanners; report, don't die
+            crashed.append(label)
+            warnings.append(f"{label} crashed ({type(e).__name__}: {e}); its results are missing")
+            return default
+
+    findings, n_tools = guarded("mcpaudit (source)", scan_mcp_source, ([], 0), root, include_tests, warnings)
+    findings = list(findings)
+    findings += guarded("mcpaudit (manifests)", scan_manifest_files, [], root, warnings)
+    findings += guarded("memsentry", scan_context_files, [], root, warnings)
+    if rag:
+        findings += guarded("ragsentry", scan_rag_dir, [], rag.resolve(), root, warnings)
+    findings.sort(key=lambda f: (-SEVERITY_ORDER[f.severity], f.file, f.line))
+
+    if write_baseline:
+        write_baseline.write_text(json.dumps(sorted({f.fingerprint for f in findings}), indent=2))
+        typer.echo(f"baseline written: {len(findings)} findings accepted -> {write_baseline}")
+    suppressed = 0
+    if baseline:
+        try:
+            accepted = set(json.loads(baseline.read_text()))
+        except (OSError, ValueError) as e:
+            raise typer.BadParameter(f"cannot read baseline: {e}")
+        kept = [f for f in findings if f.fingerprint not in accepted]
+        suppressed, findings = len(findings) - len(kept), kept
+
+    if sarif:
+        sarif.write_text(json.dumps(to_sarif(findings), indent=2), encoding="utf-8")
+    if json_out:
+        json_out.write_text(json.dumps([f.to_dict() for f in findings], indent=2), encoding="utf-8")
+
+    summary = summary or (pathlib.Path(os.environ["GITHUB_STEP_SUMMARY"]) if os.environ.get("GITHUB_STEP_SUMMARY") else None)
+    if summary:
+        with summary.open("a", encoding="utf-8") as fh:
+            fh.write(to_markdown(findings, n_tools, warnings, suppressed))
+
+    for w in warnings:
+        typer.echo(f"warning: {w}", err=True)
+    by_sev = collections.Counter(f.severity for f in findings)
+    typer.echo(f"tools extracted: {n_tools} | findings: {len(findings)} "
+               f"(critical {by_sev['critical']}, high {by_sev['high']}, medium {by_sev['medium']}, low {by_sev['low']})"
+               + (f" | baseline-suppressed: {suppressed}" if suppressed else ""))
+    if n_tools == 0:
+        typer.echo("note: no MCP tools were found statically; that means 'unknown', not 'safe'.")
+    for f in findings[:25]:
+        typer.echo(f"  [{f.severity:8}] {f.file}:{f.line}  {f.scanner}  {f.rule}")
+    if len(findings) > 25:
+        typer.echo(f"  ... and {len(findings) - 25} more (use --json or --sarif for all)")
+    if fail_on and crashed and not any(at_least(f.severity, fail_on) for f in findings):
+        typer.echo(f"error: {len(crashed)} scanner(s) crashed, so a clean result can't be trusted (exit 2)", err=True)
+        raise typer.Exit(2)
+    if fail_on and any(at_least(f.severity, fail_on) for f in findings):
+        raise typer.Exit(1)

aisec/extract.py

@@ -0,0 +1,180 @@
+"""Statically extract MCP tool definitions (name, description, input schema) from source code.
+
+No code is executed. Supports Python FastMCP-style decorators (via ast) and TypeScript/JavaScript
+registerTool()/addTool()/server.tool() calls with zod or JSON schemas, plus generic
+{name, description, inputSchema} object literals. Best-effort: a 90-repo study found about 60% of
+repos yielded tools, so treat "no tools found" as "unknown", not "safe".
+"""
+from __future__ import annotations
+
+import ast
+import pathlib
+import re
+
+_ALWAYS_SKIP = {"node_modules", ".git", "dist", "build", "venv", ".venv", "__pycache__", "docs"}
+_TEST_DIRS = {"tests", "test", "__tests__", "examples", "example", "e2e", "bench", "fixtures", "scripts"}
+_TEST_FILE = re.compile(r"\.(spec|test)\.[jt]sx?$")
+_STR = r'(?:"((?:[^"\\]|\\.)*)"|\'((?:[^\'\\]|\\.)*)\'|`((?:[^`\\]|\\.)*)`)'
+_ANCHOR = re.compile(r"(?:registerTool|addTool|defineTool|definePageTool|\.tool)\s*\(\s*")
+
+
+def _lit(m):
+    return next(g for g in m.groups() if g is not None)
+
+
+def _files(root: pathlib.Path, exts, include_tests: bool):
+    skip = set(_ALWAYS_SKIP) | (set() if include_tests else _TEST_DIRS)
+    for p in root.rglob("*"):
+        if p.suffix in exts and p.is_file() and p.stat().st_size < 400_000:
+            rel = p.relative_to(root)
+            if set(rel.parts[:-1]) & skip:
+                continue
+            if not include_tests and _TEST_FILE.search(p.name):
+                continue
+            yield p
+
+
+def _py_tools(path: pathlib.Path) -> list[dict]:
+    try:
+        tree = ast.parse(path.read_text(errors="ignore"))
+    except Exception:
+        return []
+    out = []
+    for fn in ast.walk(tree):
+        if not isinstance(fn, (ast.FunctionDef, ast.AsyncFunctionDef)):
+            continue
+        dec = None
+        for d in fn.decorator_list:
+            base = d.func if isinstance(d, ast.Call) else d
+            if (isinstance(base, ast.Attribute) and base.attr == "tool") or (isinstance(base, ast.Name) and base.id == "tool"):
+                dec = d
+                break
+        if dec is None:
+            continue
+        name, desc = fn.name, ast.get_docstring(fn) or ""
+        if isinstance(dec, ast.Call):
+            for kw in dec.keywords:
+                if kw.arg == "name" and isinstance(kw.value, ast.Constant):
+                    name = str(kw.value.value)
+                if kw.arg == "description" and isinstance(kw.value, ast.Constant):
+                    desc = str(kw.value.value)
+            if dec.args and isinstance(dec.args[0], ast.Constant) and isinstance(dec.args[0].value, str):
+                name = dec.args[0].value
+        props = {}
+        for a in fn.args.args + fn.args.kwonlyargs:
+            if a.arg in ("self", "cls", "ctx", "context"):
+                continue
+            ann = ast.unparse(a.annotation) if a.annotation else ""
+            if "Context" in ann:
+                continue
+            s: dict = {"type": "string"}
+            if ann.startswith("Literal["):
+                s["enum"] = ["?"]
+            elif re.search(r"\bint\b", ann):
+                s = {"type": "integer"}
+            elif re.search(r"\bfloat\b", ann):
+                s = {"type": "number"}
+            elif re.search(r"\bbool\b", ann):
+                s = {"type": "boolean"}
+            elif re.search(r"\b(list|List)\b", ann):
+                s = {"type": "array"}
+            elif re.search(r"\b(dict|Dict)\b", ann) or (ann and not re.search(r"\bstr\b", ann)):
+                s = {"type": "object"}
+            props[a.arg] = s
+        out.append(dict(name=name, description=desc, input_schema={"type": "object", "properties": props}, line=fn.lineno))
+    return out
+
+
+def _zod_props(block: str) -> dict:
+    props = {}
+    for m in re.finditer(r"(\w+)\s*:\s*(?:z|zod)\s*\.\s*(string|number|boolean|enum|array|object|any|union|record)\s*\(([^)]*)\)([^,\n]*(?:\n\s*\.[^,\n]*)*)", block):
+        key, kind, _arg, chain = m.groups()
+        s = {"type": {"string": "string", "number": "number", "boolean": "boolean", "array": "array", "enum": "string"}.get(kind, "object")}
+        if kind == "enum":
+            s["enum"] = ["?"]
+        if re.search(r"\.regex\(|\.startsWith\(|\.endsWith\(|\.includes\(", chain):
+            s["pattern"] = "?"
+        if re.search(r"\.max\(|\.length\(", chain) and kind == "string":
+            s["maxLength"] = 1
+        if re.search(r"\.(url|email|uuid|datetime)\(", chain):
+            s["format"] = "?"
+        props[key] = s
+    return props
+
+
+def _json_props(block: str) -> dict:
+    props = {}
+    for pm in re.finditer(r"(\w+)\s*:\s*\{\s*type\s*:\s*['\"](\w+)['\"]([^{}]*)\}", block):
+        k, ty, tail = pm.groups()
+        sc = {"type": ty}
+        for f in ("enum", "pattern", "format", "maxLength"):
+            if re.search(r"\b%s\s*:" % f, tail):
+                sc[f] = "?"
+        props[k] = sc
+    return props
+
+
+def _collect_consts(text: str, consts: dict) -> None:
+    for m in re.finditer(r"(?:const|let|var)\s+([A-Za-z_]\w*)\s*=\s*" + _STR + r"\s*(?:as const)?\s*[;\n]", text):
+        consts[m.group(1)] = next(g for g in m.groups()[1:] if g is not None)
+
+
+def _ts_tools(path: pathlib.Path, consts: dict) -> list[dict]:
+    t = path.read_text(errors="ignore")
+    out = []
+    anchors = list(_ANCHOR.finditer(t))
+    for i, m in enumerate(anchors):
+        end = anchors[i + 1].start() if i + 1 < len(anchors) else len(t)
+        win = t[m.end(): min(end, m.end() + 4500)]
+        name = None
+        if win.startswith("{"):
+            nm = re.search(r"\bname\s*:\s*(?:" + _STR + r"|([A-Za-z_]\w*))", win[:600])
+        else:
+            nm = re.match(r"(?:" + _STR + r"|([A-Za-z_][\w.]*))\s*,", win)
+        if nm:
+            name = next((g for g in nm.groups()[:3] if g is not None), None) or consts.get(nm.group(4))
+        if not name:
+            continue
+        desc = None
+        dm = None if win.startswith("{") else re.match(r"(?:" + _STR + r")\s*,\s*" + _STR, win)
+        if dm:
+            desc = next(g for g in dm.groups()[3:] if g is not None)
+        else:
+            dd = re.search(r"description\s*:\s*" + _STR, win)
+            if dd:
+                desc = _lit(dd)
+        if desc is None:
+            continue
+        props = _zod_props(win)
+        props.update({k: v for k, v in _json_props(win).items() if k not in props})
+        out.append(dict(name=name, description=desc, input_schema={"type": "object", "properties": props}, line=t.count("\n", 0, m.start()) + 1))
+    return out
+
+
+def extract_tools(root: str | pathlib.Path, include_tests: bool = False) -> list[dict]:
+    """Return de-duplicated tool dicts: name, description, input_schema, file (relative), line."""
+    root = pathlib.Path(root)
+    tools: list[dict] = []
+    for p in _files(root, {".py"}, include_tests):
+        for t in _py_tools(p):
+            tools.append({**t, "file": str(p.relative_to(root))})
+    ts = list(_files(root, {".ts", ".js", ".mjs", ".tsx"}, include_tests))
+    consts: dict = {}
+    for p in ts:
+        try:
+            _collect_consts(p.read_text(errors="ignore"), consts)
+        except Exception:
+            pass
+    for p in ts:
+        try:
+            for t in _ts_tools(p, consts):
+                tools.append({**t, "file": str(p.relative_to(root))})
+        except Exception:
+            pass
+    seen, uniq = set(), []
+    for t in tools:
+        k = (t["name"], t["description"][:60])
+        if k not in seen:
+            seen.add(k)
+            uniq.append(t)
+    return uniq

aisec/model.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import hashlib
+from dataclasses import dataclass, asdict
+
+SEVERITY_ORDER = {"low": 0, "medium": 1, "high": 2, "critical": 3}
+
+
+@dataclass
+class Finding:
+    scanner: str      # mcpaudit | memsentry | ragsentry
+    rule: str         # e.g. "permission_scope: Unscoped filesystem access"
+    severity: str     # low | medium | high | critical
+    message: str
+    file: str         # path relative to the scan root
+    line: int = 1
+
+    @property
+    def fingerprint(self) -> str:
+        """Stable across line shifts, so baselines survive unrelated edits."""
+        raw = "\x1f".join((self.scanner, self.rule, self.file.replace("\\", "/"), self.message))
+        return hashlib.sha256(raw.encode()).hexdigest()[:32]
+
+    def to_dict(self) -> dict:
+        return {**asdict(self), "fingerprint": self.fingerprint}
+
+
+def at_least(severity: str, threshold: str) -> bool:
+    return SEVERITY_ORDER[severity] >= SEVERITY_ORDER[threshold]

aisec/sarif.py

@@ -0,0 +1,44 @@
+"""Minimal SARIF 2.1.0 writer so findings show up in GitHub code scanning."""
+from __future__ import annotations
+
+import re
+
+from aisec import __version__
+from aisec.model import Finding
+
+_LEVEL = {"critical": "error", "high": "error", "medium": "warning", "low": "note"}
+# GitHub ranks code-scanning alerts by this CVSS-like number (>=9 critical, 7-8.9 high, 4-6.9 medium, <4 low).
+_SECURITY_SEVERITY = {"critical": "9.5", "high": "8.0", "medium": "5.5", "low": "2.0"}
+_HELP = {"mcpaudit": "https://github.com/Pyhroff/mcpaudit", "memsentry": "https://github.com/Pyhroff/memsentry",
+         "ragsentry": "https://github.com/Pyhroff/ragsentry"}
+
+
+def _rule_id(f: Finding) -> str:
+    return f"{f.scanner}/" + re.sub(r"[^A-Za-z0-9_.-]+", "-", f.rule).strip("-").lower()
+
+
+def to_sarif(findings: list[Finding]) -> dict:
+    rules: dict[str, dict] = {}
+    results = []
+    for f in findings:
+        rid = _rule_id(f)
+        rules.setdefault(rid, {"id": rid, "name": rid, "shortDescription": {"text": f.rule},
+                               "helpUri": _HELP.get(f.scanner, "https://github.com/Pyhroff/aisec-suite"),
+                               "properties": {"scanner": f.scanner, "security-severity": _SECURITY_SEVERITY[f.severity],
+                                              "tags": ["security", "ai-security", f.scanner]}})
+        results.append({
+            "ruleId": rid,
+            "level": _LEVEL[f.severity],
+            "message": {"text": f.message},
+            "locations": [{"physicalLocation": {"artifactLocation": {"uri": f.file.replace("\\", "/")},
+                                                "region": {"startLine": max(1, f.line)}}}],
+            "partialFingerprints": {"aisec/v1": f.fingerprint},
+            "properties": {"severity": f.severity, "scanner": f.scanner},
+        })
+    return {
+        "$schema": "https://json.schemastore.org/sarif-2.1.0.json",
+        "version": "2.1.0",
+        "runs": [{"tool": {"driver": {"name": "aisec-suite", "version": __version__,
+                                      "informationUri": "https://github.com/Pyhroff", "rules": list(rules.values())}},
+                  "results": results}],
+    }

aisec/summary.py

@@ -0,0 +1,31 @@
+"""Markdown job summary (GitHub renders $GITHUB_STEP_SUMMARY on the run page)."""
+from __future__ import annotations
+
+import collections
+
+from aisec.model import Finding
+
+_ICON = {"critical": "🟥", "high": "🟧", "medium": "🟨", "low": "⬜"}
+
+
+def _cell(text: str) -> str:
+    return text.replace("|", "\\|").replace("\n", " ")[:160]
+
+
+def to_markdown(findings: list[Finding], n_tools: int, warnings: list[str], suppressed: int = 0) -> str:
+    by = collections.Counter(f.severity for f in findings)
+    out = ["## aisec-suite scan\n",
+           f"**{len(findings)} finding(s)** · critical {by['critical']} · high {by['high']} · "
+           f"medium {by['medium']} · low {by['low']} · MCP tools extracted: {n_tools}"
+           + (f" · {suppressed} accepted via baseline" if suppressed else "") + "\n"]
+    if n_tools == 0:
+        out.append("> No MCP tools were found statically. That means *unknown*, not *safe*.\n")
+    for w in warnings:
+        out.append(f"> ⚠️ {_cell(w)}\n")
+    if findings:
+        out.append("| Severity | Scanner | Rule | Location |\n|---|---|---|---|")
+        for f in findings[:50]:
+            out.append(f"| {_ICON[f.severity]} {f.severity} | {f.scanner} | {_cell(f.rule)} | `{_cell(f.file)}:{f.line}` |")
+        if len(findings) > 50:
+            out.append(f"\n…and {len(findings) - 50} more in the SARIF/JSON output.")
+    return "\n".join(out) + "\n"

aisec_suite-0.2.0.dist-info/METADATA

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: aisec-suite
+Version: 0.2.0
+Summary: One command that runs mcpaudit, memsentry and ragsentry on a repo and emits SARIF for GitHub code scanning.
+Author: Pyhroff
+License: MIT
+Project-URL: Homepage, https://github.com/Pyhroff/aisec-suite
+Project-URL: Issues, https://github.com/Pyhroff/aisec-suite/issues
+Project-URL: Changelog, https://github.com/Pyhroff/aisec-suite/blob/main/CHANGELOG.md
+Keywords: MCP,prompt injection,SARIF,AI security,LLM agents,code scanning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Provides-Extra: scanners
+Requires-Dist: pyhroff-mcpaudit>=0.7; extra == "scanners"
+Requires-Dist: memsentry>=1.2; extra == "scanners"
+Requires-Dist: pyhroff-ragsentry>=1.1; extra == "scanners"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# aisec-suite
+
+[![tests](https://github.com/Pyhroff/aisec-suite/actions/workflows/tests.yml/badge.svg)](https://github.com/Pyhroff/aisec-suite/actions/workflows/tests.yml) ![python](https://img.shields.io/badge/python-3.10%E2%80%933.12-blue) ![license](https://img.shields.io/badge/license-MIT-green)
+
+One command that runs three AI-security scanners on a repository and writes SARIF for GitHub code scanning.
+
+| Scanner | What it checks | Input found automatically |
+|---|---|---|
+| [mcpaudit](https://github.com/Pyhroff/mcpaudit) | MCP tool poisoning and over-broad tool scope (static checks) | Tool definitions **extracted statically from source** (Python FastMCP decorators, TS/JS `registerTool`/`addTool`/`server.tool`), plus manifest `*.json` files |
+| [memsentry](https://github.com/Pyhroff/memsentry) | Injected instructions and hidden payloads in agent context files | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`, `.windsurfrules`, `.clinerules`, `.cursor/rules/*`, `copilot-instructions.md` |
+| [ragsentry](https://github.com/Pyhroff/ragsentry) | Injection and retrieval manipulation in RAG source documents | A directory you pass with `--rag` |
+
+No third-party code is executed: tool definitions are read from source, not by launching the server.
+
+```bash
+pip install "aisec-suite[scanners]"   # also installs pyhroff-mcpaudit, memsentry, pyhroff-ragsentry from PyPI
+aisec scan . --sarif aisec.sarif --fail-on high
+aisec scan . --rag ./docs --json findings.json
+```
+
+Exit codes: `0` clean, `1` a finding at or above `--fail-on`, `2` a scanner crashed (so a clean result can't be trusted; only with `--fail-on`). Use `--include-tests` to also extract tools from tests/examples/fixtures.
+
+### Adopting it on an existing repo without a wall of red
+```bash
+aisec scan . --write-baseline .aisec-baseline.json     # accept what exists today
+aisec scan . --baseline .aisec-baseline.json --fail-on high   # CI now fails only on NEW findings
+```
+Fingerprints ignore line numbers, so moving code around does not resurface accepted findings. Every run also writes a Markdown table to the GitHub job summary (`--summary`).
+
+## GitHub Action
+One line, no install step; the scanners come from PyPI:
+
+```yaml
+permissions:
+  contents: read
+  security-events: write
+steps:
+  - uses: actions/checkout@v4
+  - uses: Pyhroff/aisec-suite@v0.2.0
+    with:
+      fail-on: high
+```
+
+Inputs: `path`, `fail-on`, `rag-dir`, `baseline`, `install`, `upload-sarif`. Needs `security-events: write` for the upload step. Inputs reach the shell only through quoted env vars, never interpolated into script text.
+
+(The action itself has not yet been run on GitHub Actions; the CLI and adapters are tested, including with fake scanners in CI.)
+
+## Honest scope
+- Static extraction is best-effort. In a study of 90 public MCP repos it found tools in 53 (about 59%); "no tools found" prints a note and means *unknown*, not *safe*.
+- Findings are heuristics for human review. In the same study only 37.5% (95% CI 24-53%) of mcpaudit v0.6's HIGH `permission_scope` findings were accurate, and none of the flagged repos had genuine tool poisoning. Use the patched scanners (mcpaudit 0.7 / memsentry 1.2) for fewer false positives; see `mcp-scan-study/REPORT.md`.
+- mcpaudit's dynamic (live LLM) and rug-pull checks are not part of this suite; use mcpaudit directly for those.
+- Line numbers for extracted tools point at the registration call, not the description text.
+
+## Development
+`pip install -e ".[dev]" && pytest -q` (adapter tests use in-memory fake scanners and always run; a few end-to-end tests skip unless the real scanners are installed).

aisec_suite-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+aisec/__init__.py,sha256=1bTDEiRxMMrBBaR-p0h_ZlWVcSTcBtsZskz9xa-3GvI,114
+aisec/adapters.py,sha256=GV_H5GY_QTEBSsdR65sXkArjFUixSu0WzT4shY52Y1g,4851
+aisec/cli.py,sha256=F8saZv7V9_JQtNQHY4KBTa-kGIMHcq3v8XFoaRhE-VE,5216
+aisec/extract.py,sha256=M-vj6QhoGSAAed2b6gMsFWv6ueAK7DGnEYWqk_zXzK4,7492
+aisec/model.py,sha256=RaIfZi8ahPVvAcaq7vWEZa-3zq8AT5Mi6H2l7fkYYGM,970
+aisec/sarif.py,sha256=I7jrcTvou5JGJZBWZVmoLaPGhXoC5kZ-_s95GzRVOQc,2173
+aisec/summary.py,sha256=dCFWGRuvE3gM3f0-c_OjCxbnxEbrGu4JQPr3HdTmwTM,1410
+aisec_suite-0.2.0.dist-info/licenses/LICENSE,sha256=Skd0_F-tLTX1HDTM9NyFSIbQaDW0dM1_ydtr6-3zztQ,1064
+aisec_suite-0.2.0.dist-info/METADATA,sha256=zMEap44PLn-_0a6EDMdtAXas2u6rTpLzdonLj-c-zcE,4921
+aisec_suite-0.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+aisec_suite-0.2.0.dist-info/entry_points.txt,sha256=2GtLKi4xRLIh3no0XUbqorABt3N33Pj2DyIfTHr-0_0,40
+aisec_suite-0.2.0.dist-info/top_level.txt,sha256=f1wDe-4raesgkQQklIK5P9A3_n6oyDiYpYzazZ5LKb4,6
+aisec_suite-0.2.0.dist-info/RECORD,,

aisec_suite-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aisec_suite-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aisec = aisec.cli:app

aisec_suite-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Pyhroff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

aisec_suite-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+aisec