Knossos-MCP

Wat het doet ​

Vraag een agent wat er van een klasse afhangt en hij leest de broncode opnieuw, elke sessie, en vertelt je wat hij eruit heeft afgeleid. Knossos-MCP scant de repository één keer en antwoordt uit een graph waarin elk feit een bestand en een regel bij zich draagt. Wat statische analyse niet kan bewijzen, krijgt een confidence-label, geen stille gok.

Vier talen komen samen in dezelfde graph. Een Vue-component die een PHP-endpoint aanroept, een Python-worker die dat endpoint consumeert, een Rust-binary ernaast: ze worden samengevoegd tot één geheel van nodes en relaties, zodat een impactvraag een taalgrens net zo makkelijk oversteekt als de code zelf.

Scannen installeert nooit dependencies, importeert nooit een module en start nooit een framework op: workers draaien gesuperviseerd, met een resource-limiet, en hun uitvoer telt pas mee nadat die een schema- en limietcontrole doorstaat. Drieëndertig MCP-tools dekken oriëntatie, projecten en historie, het opzoeken van componenten, structuur- en impactanalyse en onderhoud; alleen server_info heeft geen CLI-equivalent. De vier schrijftools tonen standaard een preview en passen pas iets toe zodra je expliciet execute meegeeft.

Snel starten ​

Knossos-MCP staat nog niet op Packagist of in een container-registry, dus bouw de image zelf vanaf de broncode. De aanbevolen distributie is Docker: die pint PHP, Node, Python, Composer, SQLite, de PHP-parser en de TypeScript-compiler vast, zodat het gescande project daar zelf niets van nodig hoeft te hebben. De Rust-worker wordt in een builder-stage gecompileerd en als binary gekopieerd, dus ook een Rust-toolchain zit niet in de runtime-image.

docker build -t knossos-mcp:dev .
docker run --rm knossos-mcp:dev doctor --json

Voorbeelden ​

Twee aanroepen, echt uitgevoerd op de eigen broncode van Knossos-MCP, ingekort met '…'.

Een scan van de repository:

$ knossos scan . --json
{"summary":"Scanned 411 files into 5851 nodes and 33284 relationships.",
 "data":{"files":411,"nodes":5851,"edges":33284,"diagnostics":0,"mode":"full",
   "scanner_metadata":{"knossos.php":{"files_scanned":377},
     "knossos.typescript":{"files_scanned":17,"programs":1},
     "knossos.python":{"files_scanned":7,"parser":"python.ast"},
     "knossos.rust":{"files_scanned":10,"parser":"rust.syn"}},
   "metrics":{"elapsed_ms":6494.8, …}}}

Alle vier de workers dragen bij aan die ene scan, en er komt geen enkele diagnostic uit.

Jezelf oriënteren in de resulterende graph:

$ knossos architecture-summary project_1b4f41… --json
{"summary":"Knossos-MCP contains 5851 nodes and 33284 relationships.",
 "data":{"node_kinds":[{"kind":"method","count":3979},{"kind":"class","count":437},
   {"kind":"external_method","count":407},{"kind":"external_function","count":310},
   {"kind":"function","count":297}, …],
   "languages":[{"kind":"php","count":377},{"kind":"javascript","count":17},
     {"kind":"rust","count":10},{"kind":"python","count":7}]}}

Mogelijkheden ​

Rust is de enige taal die optioneel is bij een native installatie: zonder cargo is er geen Rust-worker, en de container heeft er altijd een.

Gemengde repositories komen samen in één graph. impact_analysis en verwante tools labelen elke conclusie met een confidence (certain, probable, possible) in plaats van hem als zekerheid te presenteren. Een relatie waar de scanner niet voor kan instaan, laat hij weg. Dat is een bewuste false negative.

Configuratie ​

Knossos-MCP leest knossos.json (of knossos.jsonc) uit de root van het gescande project. Dit is de configuratie van Knossos-MCP zelf:

{
  "$schema": "./schemas/project-config-v1.schema.json",
  "version": 1,
  "ignores": ["tests/Fixtures"],
  "boundaries": [
    { "name": "core", "path_prefix": "src" },
    { "name": "php-worker", "path_prefix": "workers/php" },
    { "name": "typescript-worker", "path_prefix": "workers/typescript" },
    { "name": "python-worker", "path_prefix": "workers/python" },
    { "name": "tooling", "path_prefix": "tools" },
    { "name": "tests", "path_prefix": "tests" }
  ],
  "policies": [
    {
      "id": "workers-are-out-of-process",
      "from_boundary": "php-worker",
      "deny_targets": ["core"]
    }
  ],
  "quality_budgets": {
    "new_cycles": 0,
    "boundary_violations": 0,
    "error_diagnostics": 0,
    "warning_diagnostics": 0,
    "hub_degree_growth": 25,
    "unreferenced_candidates": 110
  }
}

boundaries verdeelt de codebase in benoemde grenzen; policies verbiedt specifieke relaties tussen die grenzen, en check_architecture toetst elke wijziging eraan. quality_budgets zet harde drempels op regressies zoals nieuwe circulaire afhankelijkheden of grensoverschrijdingen, gecontroleerd door quality_gate.