Catalog PyPI
Back to packageRELEASE DETAILS

0.9.3

PyPI

aevrin-scanner

Shared scanning engine for Aevrin: models, OWASP MCP Top 10 mapping, scoring, and containerized scanner adapters. Imported by backend/apps/api and backend/apps/cli so findings never drift into different vocabularies.

Published20 Oct 2026
Direct dependencies2
Transitive dependenciesNot calculated

README

Version 0.9.3 documentation

Aevrin Scanner Core

This package is no longer updated. 0.9.3 is the last release of aevrin-scanner, the library the Python aevrin CLI used. The CLI is now the npm package aevrin (npm install -g aevrin), which carries its own scanner.

The shared scanning layer used by the Aevrin API and CLI. It resolves a target to a launch command, runs the version-pinned MCP security engine against the live server inside an isolated container, normalizes the engine's output into one finding model, maps findings to the OWASP MCP Top 10, and records what could not be assessed.

It does not decide security. The engine assigns severities, scores and grades; this package presents them.

This package is primarily an internal runtime dependency. Most users should install the aevrin CLI instead.

Development

uv sync
uv run ruff check .
uv run mypy -p aevrin.scanner
uv run pytest

Scans require a reachable Docker daemon. There is no subprocess fallback: scanning an MCP server means starting it, which executes code published by someone else, so a scan without a sandbox does not run at all. See DECISIONS.md ADR-034.

Security model

  • The scan container receives an allow-listed environment - never the Supabase service-role key, a provider key, or a cloud credential. It runs non-root, read-only, with every capability dropped and a hard timeout.
  • A launch command is read from the project's own manifest, never guessed from a repository name: guessing scans a different package and attributes the grade to the wrong publisher.
  • A scan that could not launch or enumerate is INCOMPLETE and receives no grade; missing coverage is never presented as a clean scan.
  • Prompt injection through live tool responses (MCP08) remains explicitly outside static-scan coverage.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 2

Native requirements
2 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pydantic>=2.9runtime
tomli
Environment
{
  "extras": "",
  "marker": "python_full_version < \"3.11\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
tomli>=2.0; python_full_version < "3.11"runtime

Distribution files

2 collected
aevrin_scanner-0.9.3-py3-none-any.whl

bdist_wheel · 97.58 KB · Python py3

Source file
aevrin_scanner-0.9.3.tar.gz

sdist · 82.41 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 20:58 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:e34751dd438b6510ec80e2a4a0204800bb329ce842b027f40192579ef0f173c5

Other collected versions

View all collected versions →