io.github.TKMD/reftrixmcp

What we checked

Six static checks, weighted by risk. Every result reflects only what could be observed in the published package and repository — never intent.

• Injection surface

  unscannable25% of grade

  Tool descriptions/manifest scanned for instruction-injection patterns (imperatives at the model, hidden text, 'ignore previous', data-exfil URLs).

  No tool descriptions, server instructions, prompts, or resources were fetched; nothing to scan for injection.

• Supply chain

  warn25% of grade

  Package provenance: namespace verification, repo linkage, maintainer count, account age, postinstall scripts, typosquat distance.

  dependency "culori" is edit-distance 2 from popular package "colors" (typosquat candidate); dependency "@prisma/client" is edit-distance 2 from popular package "@aws-sdk/client-s3" (typosquat candidate); dependency "@reftrixmcp/ml" is edit-distance 2 from popular package "pm2" (typosquat candidate); dependency "@reftrixmcp/core" is edit-distance 1 from popular package "cors" (typosquat candidate)

• Credential hygiene

  pass15% of grade

  How the server takes secrets (env vs plaintext config vs hardcoded); secrets appearing in tool schemas.

  Reads secrets from the environment (e.g. src/middleware/auth.ts) — the recommended intake shape. PASS = no static red flag; static analysis cannot prove the code honors env-based secret handling at runtime.

• Permission scope

  fail15% of grade

  Declared tools vs. breadth (filesystem, network, exec); flags shell-exec and unbounded filesystem access.

  HIGH: src/utils/path-security.ts: references a sensitive credential path (\.ssh\) — the tool-poisoning exfiltration target. HIGH: shell/exec capability AND network egress together — download-and-execute risk (src/scripts/backfill-embeddings.ts: imports child_process and calls exec/spawn; src/services/external-css-fetcher.ts: outbound HTTP/socket call). HIGH: shell/exec capability AND destructive filesystem writes together (src/scripts/backfill-embeddings.ts: imports child_process and calls exec/spawn; src/tools/motion/analyze-frames.handler.ts: path traversal ('../') combined with file access). discloses shell/exec capability: src/scripts/backfill-embeddings.ts: imports child_process and calls exec/spawn discloses shell/exec capability: src/services/browser-process-manager.ts: imports child_process and calls exec/spawn discloses shell/exec capability: src/services/database-dumper.service.ts: imports child_process and calls exec/spawn discloses shell/exec capability: src/services/page/frame-analyzer.service.ts: imports child_process and calls exec/spawn discloses shell/exec capability: src/services/vision/hardware-detector.ts: imports child_process and calls exec/spawn discloses shell/exec capability: src/services/vision/vram-utils.ts: imports child_process discloses shell/exec capability: src/services/worker-supervisor.service.ts: imports child_process and calls exec/spawn discloses broad/destructive filesystem access: src/tools/motion/analyze-frames.handler.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/analyze.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/middleware/auth.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/scripts/backfill-embeddings.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/background/background-design-detector.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/quality/batch-evaluate.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/layout/batch-ingest.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/quality/benchmark.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision/brandtone.analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/brief/brief-parser-service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/scripts/check-embedding-coverage.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/checksum-service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/part/compare.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/visual/css-variable-extractor.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/database-dumper.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/motion/detect.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/common/error-codes.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/quality/evaluate.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/existing-animation-detector.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/fallback-analyzer.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/frame-analyzer.service.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/page/frame-analyzer.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/frame-capture.service.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/motion/analyzers/frame-diff.analyzer.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/motion/analyzers/frame-diff.analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/infrastructure/frame-loader.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/get-job-status.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/quality/get-job-status.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/preference/get.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/gpu-resource-manager.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/visual-extractor/gradient-detector.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/api/health.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/preference/hear.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/visual-extractor/image-utils.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/layout/ingest.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/layout/inspect/inspect.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/part/inspect.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/js-animation-detector.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/js-animation-embedding.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/handlers/js-animation-handler.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/layout-analyzer.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/layout-embedding.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/layout-to-code.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision-adapter/llama-vision.adapter.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/storage/local-storage.provider.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/storage/local-storage.provider.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision-adapter/local.adapter.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision/mcp-progress-adapter.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/metrics-collector.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/ml/mood-brandtone-embedding.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision/mood.analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/motion-category-classifier.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/handlers/motion-handler.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion-search.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/analyzers/motion-vector.estimator.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/responsive/multi-viewport-capture.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/narrative/narrative-analysis.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/handlers/narrative-handler.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/narrative/narrative-search.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page-ingest-adapter.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/part/part-bbox-playwright.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/part/part-db.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/persistent-cache.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/persistent-cache.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/workers/phases/phase-2-motion.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/workers/phases/phase-5-embedding.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/quality/playwright-axe.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/playwright-crawler.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/preference-rerank.helper.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/production-guard.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/project-context-analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/project-get.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/project-list.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/preference/reset.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/runtime-animation-detector.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/background/search.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/layout/search.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/motion/search.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/part/search.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/responsive/search.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/part/section-screenshot-fallback.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/section-screenshot.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/service-client.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/service-initializer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/scripts/start-workers.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/style-get-palette.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/system-health.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/vision/theme.analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/three-js-scene-extractor.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/layout/to-code.tool.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/workers/phases/types.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/visual/typography-extractor.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/brief/validate.handler.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/page/video-recorder.service.ts: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/services/page/video-recorder.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/visual-category-classifier.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/visual-extractor/visual-feature-merger.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/webgl-animation-categorizer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/webgl-animation-detector.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/webgl-animation-embedding.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/tools/page/handlers/webgl-detector.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/motion/analyzers/webgl-motion-analyzer.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/worker-db-save.service.ts: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/services/worker-supervisor.service.ts: path traversal ('../') combined with file access Capability DISCLOSURE, not a verdict: static analysis sees the primitive is present and reachable, not whether its use is attacker-controlled.

• Version behavior

  unscannable10% of grade

  Diff of tool definitions between versions; new permissions or changed descriptions in a patch release (the postmark-mcp class).

  no prior version to diff (first sight of io.github.TKMD/[email protected]); version-drift / rug-pull cannot be evaluated. Cold-start risk is covered by point-in-time checks (injection_surface, supply_chain, credential_hygiene), not here.

• Transport config

  warn10% of grade

  Remote servers: TLS and auth mode (none/token/OAuth). Local servers: whether the manifest indicates it phones home.

  manifest/source references heartbeat behavior — disclosure